home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / robin_.zip / ROBIN.DOC < prev    next >
Text File  |  1990-11-12  |  138KB  |  2,809 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                  ----------------------------------
  15.  
  16.                  ROBIN!
  17.  
  18.                  An Online Aid for Prodigy(r) Users
  19.  
  20.                  ----------------------------------
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                  VERSION 1.6
  35.  
  36.                  Copyright 1990
  37.  
  38.                  McQuay Technologies
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.                  Prodigy(r) is a registered service mark and trademark of
  55.                  Prodigy Services Company, a partnership of IBM and Sears.
  56.  
  57.                  Robin!(r) is a service mark and trademark of McQuay
  58.                  Technologies.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                      TABLE OF CONTENTS
  70.                  ---------------------------------------------------------
  71.  
  72.                  INTRODUCTION TO ROBIN!                            1
  73.  
  74.                  INSTALLATION AND GETTING STARTED                  1
  75.                       WHOOPS!  Did not work?                       3
  76.                       Starting prodigy and robin                   4
  77.  
  78.                  ROBIN!'S FEATURES                                 5
  79.                       Introduction                                 5
  80.                            User Input                              5
  81.                       Main Menu    ALT-TAB                         6
  82.                       ALT-X Canceling ROBIN!'S Actions             6
  83.                       Using ROBIN! to Log On to Prodigy            7
  84.                       Sending Printer Output to a File             9
  85.                            LOG FILES                              11
  86.                            Formatting Printer Output              12
  87.                       Uploading a Text File to Prodigy Message
  88.                         Center or BBS                             13
  89.                            Quick Notes                            13
  90.                            Long Notes                             15
  91.                            Sending Long Notes to a List of
  92.                              People                               17
  93.                            Using Your Word Processor or Editor    18
  94.                       Using ROBIN! scripts to Automate Prodigy
  95.                         Services                                  19
  96.                            What is a ROBIN! script?               19
  97.                            How do you use them while online with
  98.                               Prodigy?                            19
  99.                            How do you create them?                20
  100.                            What are some of the things you can
  101.                               do with Scripts?                    20
  102.                       The SYSTEM MENU                             21
  103.                            Using The Dialog Box                   21
  104.                            Printer Format                         21
  105.                            System Path                            22
  106.                            Script Display                         22
  107.                            Node Wait Time                         22
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                  TABLE OF CONTENTS (CONT)
  117.                  ---------------------------------------------------------
  118.  
  119.                  ROBIN! SCRIPT WRITER AND LANGUAGE.               22
  120.                       How To Start The Compiler                   23
  121.                       How To Write A Script File                  23
  122.                       Script file structure                       24
  123.                       Prodigy Workings                            25
  124.                       The Language                                27
  125.  
  126.                  ADVANCED FEATURES                                29
  127.                       Command Line Switches                       29
  128.                            A=<n>  Automatic Login                 29
  129.                            V=<video type>  Set Video Mode
  130.                               for Prodigy.                        29
  131.                            D=<pathname>  Path to all ROBIN!
  132.                               scratch files                       30
  133.                       ROBIN! IN THE WINDOW (WINDOWS 3)            30
  134.                       ROBIN! Configuration Program RCONFIG.EXE    31
  135.  
  136.                  REGISTERING YOUR SHAREWARE VERSION OF ROBIN!     32
  137.                       What does shareware mean?                   32
  138.                       How do you register?                        32
  139.                       The Reality of Shareware                    35
  140.  
  141.                  PROBLEMS                                         36
  142.                       Possible Problems and Solutions             36
  143.                       How to contact us about ROBIN! problems     39
  144.  
  145.                  APPENDIX                                         41
  146.                       System Requirements                         41
  147.                       Installing on a floppy system               41
  148.                       MEMORY PROBLEMS - UNLOADING TSRS            42
  149.                       Technical Aspects of Robin!                 43
  150.                       Some Technical Aspects of Prodigy(r),
  151.                          We Think!                                44
  152.                       Some non technical aspects of ROBIN!        46
  153.                       Possible future enhancements                47
  154.                       Why is it called ROBIN!?                    48
  155.                       What is McQuay Technologies?                49
  156.  
  157.  
  158.  
  159.                ROBIN! 1.6 November 12, 1990                     page 1
  160.  
  161.  
  162.  
  163.  
  164.           INTRODUCTION TO ROBIN!          INTRODUCTION TO ROBIN!
  165.  
  166.  
  167.                Robin! is an online aid for Prodigy(r) users.  It is
  168.                designed to make Prodigy(r) easier to use for beginners, and
  169.                faster and more productive to use for advanced users.
  170.                ROBIN! is structured around online menus that provide 3
  171.                major tools
  172.  
  173.                1) The ability to upload textfiles to Prodigy(r) from a
  174.                floppy or hard disk.
  175.  
  176.                2) The ability to route information to a textfile that
  177.                Prodigy(r) would normally send to the printer.
  178.  
  179.                3) A script language that can be used to "playback"
  180.                keystrokes as if they were typed in from the keyboard.
  181.  
  182.                Robin!'s tools can be selected from menus or selected with
  183.                hotkeys.  Beginners will find Robin!'s menus make it easier
  184.                to access Prodigy(r)'s services.  Advanced users will be
  185.                able to access Prodigy(r) services faster, and send and
  186.                receive mail with just a few keystrokes.
  187.  
  188.                The following sections discuss how to install ROBIN!, how to
  189.                use each of Robin!'s features, how to solve problems you may
  190.                encounter and how to register your shareware copy.  This
  191.                document also contains several appendicies that provide some
  192.                additional technical information about ROBIN! and Prodigy.
  193.  
  194.                We at McQuay Technologies believe in excellence in our work
  195.                and our products.  We have tried to do our best in crafting
  196.                ROBIN!.  Our goal was to create a product that is easy to
  197.                use and meets your needs.  After using this document and the
  198.                ROBIN! software, if you, our customers feel we have not done
  199.                so, then we would be the first to admit we have not yet
  200.                achieved our goal.  But more importantly we want to hear
  201.                from you on what's missing or wrong so we can add it or fix
  202.                it.  We are designing ROBIN! for you, so  ENJOY! and be
  203.                critical.
  204.  
  205.  
  206.  
  207.           INSTALLATION AND GETTING STARTED          INSTALLATION AND GETTING STARTED
  208.  
  209.  
  210.                We have tried to make the installation of ROBIN! as painless
  211.                as possible.  This is your first impression of us, and we
  212.                want to make it pleasant!  With your shareware ROBIN!
  213.                package is an install program which will help you to install
  214.                ROBIN!.  We suggest you follow these steps.
  215.  
  216.  
  217.  
  218.                ROBIN! 1.6 November 12, 1990                     page 2
  219.  
  220.  
  221.                1) Make a backup copy of the ROBIN! shareware software and
  222.                   data files, NOW!  If you originally downloaded or
  223.                   received ROBIN! as an ARC or ZIP file, then back up this
  224.                   file.  If you received ROBIN! on a disk then back up this
  225.                   disk.  Better safe than sorry.  If you received ROBIN! as
  226.                   an ARC or ZIP file, then it will have to be uncompressed.
  227.                   Likely if you are reading this, that has already been
  228.                   done.  Backup your ARC or ZIP files!
  229.  
  230.                2) View, list, or print the README.ASC file that came with
  231.                   your shareware version of ROBIN!.  It will provide
  232.                   whatever has been updated since this document was
  233.                   prepared.
  234.  
  235.                  +-----------------------------------------------+
  236.                      The current version of ROBIN!'s install                 |                                               |
  237.                      program is designed for those with Hard                 |                                               |
  238.                      Disks.  If you are using a floppy version                 |                                               |
  239.                      of prodigy, you will have to install ROBIN!                 |                                               |
  240.                      by hand.  This is not difficult.  Refer to                 |                                               |
  241.                      Floppy Disk Installation in the Appendix                 |                                               |
  242.                      for installing on a floppy based system                 |                                               |
  243.                      instead of using steps 3 and 4 below.  This                 |                                               |
  244.                      section also shows how to start ROBIN! with                 |                                               |
  245.                      a floppy system.                 |                                               |
  246.                  +-----------------------------------------------+
  247.  
  248.                3) Run the install program from the DOS prompt.  If the
  249.                   ROBIN software is on a floppy disk, then put that disk in
  250.                   a drive, make this drive the default drive by typing at
  251.                   the DOS prompt the drive's letter followed by a colon and
  252.                   pressing the return or Enter key.  For example.  If you
  253.                   have an A: drive, put your ROBIN! disk in drive A:, and
  254.                   at the DOS prompt (which should look something like this
  255.                        A>
  256.                   or this
  257.                        C>
  258.                   type the following:
  259.                        A:
  260.                   Then press the RETURN key.  Then type
  261.                        RINSTALL
  262.                   followed by the RETURN key.
  263.  
  264.                   If the ROBIN! software is on a hard disk, then make the
  265.                   directory where it is located the default directory.
  266.                   Once this is done, then type RINSTALL and press the
  267.                   Return or Enter key.
  268.  
  269.                4) Robin!'s install program will first try and find your
  270.                   Prodigy directory.  This should take no more than a
  271.                   minute.  If it does not find one (perhaps you have given
  272.                   it some name other than PRODIGY) then it will ask you to
  273.                   type in the full path name of the directory that you have
  274.                   installed Prodigy.  If it finds your Prodigy directory,
  275.  
  276.  
  277.  
  278.                ROBIN! 1.6 November 12, 1990                     page 3
  279.  
  280.  
  281.                   it will ask if this is the directory in which you want to
  282.                   install ROBIN!.  You must install ROBIN! in which Prodigy
  283.                   is installed.  But if you have Prodigy installed in
  284.                   several places, you can then identify a one of these
  285.                   other directories.  ROBIN!'s install program will now
  286.                   install ROBIN!.  This should take from 30 seconds to 4 to
  287.                   5 minutes to install, depending on the speed of your
  288.                   system.  If the Install program finds any unusual
  289.                   conditions, it may print out some error messages.  If so,
  290.                   follow the directions displayed.
  291.  
  292.                For most of you, this is all you will have to do.  You can
  293.                then start PRODIGY with a new batch file called ROBIN.  Do
  294.                the same things you did before to start Prodigy, but now
  295.                type ROBIN instead of PRODIGY.  If you have problems, first
  296.                refer to the following paragraphs.  If that does not solve
  297.                your problem then refer to the Problem Section of this
  298.                document.  If your problem still persists, then lastly
  299.                contact us on Prodigy.  You should still be able to run
  300.                prodigy as you have in the past.  See the Problem Section
  301.                below on how to contact us.
  302.  
  303.  
  304.           WHOOPS!  DID NOT WORK?
  305.  
  306.                Now we can not honestly leave our instructions for
  307.                installation at just the above.  Unfortunately, for some
  308.                there may be more you will have to do.  In this day and age
  309.                of TSR and Batch File heaven, there are so many
  310.                possibilities on what software you are using and how your PC
  311.                is configured it would be impossible for us to cover all
  312.                possibilities in an INSTALL program (Well maybe not
  313.                impossible, but not desirable).  The biggest concern you and
  314.                we will have about installation is memory.  If you are using
  315.                a lot of TSR programs, it is quite possible that you will
  316.                not be able to run ROBIN! and Prodigy at the same time.  If
  317.                this is the case you should know fairly quickly.  The ROBIN!
  318.                install program will likely complain about this if there is
  319.                a problem.  And it is possible that when you try to run
  320.                Prodigy, it will tell you there is a problem.  If either of
  321.                these happen, then you have only two choices.  1) Unload
  322.                these TSR programs from memory before running the ROBIN
  323.                batch file, or 2) Do not use ROBIN! (there is a third option
  324.                below).
  325.  
  326.                Many of today's TSR programs provide very few ways, if any,
  327.                to unload their software from memory, let alone provide
  328.                clear instructions on how to do so.  The simplest way is to
  329.                exclude it from your CONFIG.SYS file or your AUTOEXEC.BAT
  330.                file.  However, this is also the most inconvenient.  In the
  331.                Problem Section, under Not Enough Memory, we have tried to
  332.                provide some guidance for unloading TSR packages from
  333.                memory, and some other solutions you may try.
  334.  
  335.  
  336.  
  337.                ROBIN! 1.6 November 12, 1990                     page 4
  338.  
  339.  
  340.                The other major problem may be the batch file you used to
  341.                start Prodigy.  If you created your own batch file to start
  342.                Prodigy, then you should be able to look at the ROBIN.BAT
  343.                batch file and modify yours to use ROBIN!.
  344.  
  345.  
  346.  
  347.           STARTING PRODIGY AND ROBIN          STARTING PRODIGY AND ROBIN
  348.  
  349.  
  350.                ROBIN!'s install program creates a batch file in your
  351.                prodigy directory called ROBIN.BAT.  This batch file will
  352.                load ROBIN! and the start prodigy just as prodigy installed
  353.                itself on your system.  Starting  ROBIN! is fairly simple.
  354.                If Prodigy is installed on your hard disk, simply change the
  355.                default drive and directory to the Prodigy directory, and
  356.                type ROBIN.  Example
  357.  
  358.                   C:
  359.                   CD /PRODIGY
  360.                   ROBIN
  361.  
  362.                If Prodigy is installed on a floppy, then insert that floppy
  363.                in Drive A: and type
  364.  
  365.                   A:
  366.                   CD /
  367.                   ROBIN
  368.  
  369.                That is all there is to it!  There are a couple command line
  370.                parameters that you can provide when starting ROBIN!.  These
  371.                are explained in detail in the Advanced section of this
  372.                document.
  373.  
  374.                  +-----------------------------------------------+
  375.                      See Floppy Disk Installation in the                 |                                               |
  376.                      Appendix for starting ROBIN! on floppy                 |                                               |
  377.                      based systems.                 |                                               |
  378.                  +-----------------------------------------------+
  379.  
  380.  
  381.  
  382.                ROBIN! 1.6 November 12, 1990                     page 5
  383.  
  384.  
  385.  
  386.           ROBIN!'S FEATURES          ROBIN!'S FEATURES
  387.  
  388.  
  389.  
  390.           INTRODUCTION
  391.  
  392.  
  393.  
  394.                There are a variety of things you can do with ROBIN!.
  395.  
  396.                 o You can upload quick messages or big text files spread
  397.                   over multiple messages,
  398.                 o download messages to a file on your system or download to
  399.                   a file any information prodigy will let you print,
  400.                 o develop scripts that are like little programs that will
  401.                   automatically enter keystrokes into PRODIGY for you,
  402.                 o automatically log on to Prodigy with 6 different IDs when
  403.                   you first start PRODIGY or later using PRODIGY's
  404.                   exit/logon feature.
  405.  
  406.  
  407.                There are two ways to use ROBIN!'s features.  First, all of
  408.                ROBIN!'s features can be reached from the main menu, which
  409.                is displayed on PRODIGY using a hotkey.  Second, many of
  410.                ROBIN!'s features can be started directly with hot keys of
  411.                their own.  The following sections describe each of these
  412.                features.
  413.  
  414.                User Input               __________
  415.  
  416.                ROBIN! uses three types of methods to ask for user input,
  417.                keyed menus, text entry fields and toggle fields.
  418.  
  419.                Keyed menus will display a menu with a number or letter by
  420.                each option.  You can select an option by pressing the key
  421.                that corresponds with the number or letter.  If you press
  422.                the ESC key while using one of these menus, then ROBIN! will
  423.                cancel the current operation and return you to Prodigy, or
  424.                the previous Robin! menu.
  425.  
  426.                Text entry fields allow you to type in words for a response.
  427.                These fields display a box in which you can type your
  428.                response.  You can use the Backspace key to erase what has
  429.                been typed in the box.  When you press the carriage return
  430.                then ROBIN! accepts what you have typed.  Pressing the ESC
  431.                will abandoned what you have entered in the field, and
  432.                ROBIN! will discard what you typed and restore the field to
  433.                its original value.
  434.  
  435.                An extra feature in those fields where you are typing in a
  436.                filename is the Directory.  If in these fields you type a
  437.                dir search expression that contains a *, (example *.ASC)
  438.  
  439.  
  440.  
  441.                ROBIN! 1.6 November 12, 1990                     page 6
  442.  
  443.  
  444.                then ROBIN! will display a directory of the files that match
  445.                your search specification.
  446.  
  447.                Toggle fields are fields in which only a set number of
  448.                responses are appropriate.  For example, in one field only
  449.                YES and NO may be allowed.  With the toggle fields you can
  450.                use the space bar or the + key to change the value in the
  451.                field.  Pressing either of these keys will toggle the field
  452.                between its values.
  453.  
  454.                Robin! will use Dialog boxes to request user input.  With
  455.                these dialog boxes you can move from field to field with the
  456.                cursor keys or the return key.  You exit the dialog box by
  457.                pressing the ESC key.
  458.  
  459.  
  460.           MAIN MENU    ALT-TAB
  461.  
  462.                All of Robin!'s features can be accessed from its main menu.
  463.                This menu is displayed on PRODIGY's screen using a hotkey.
  464.                ROBIN!'s default hotkey is the ALT-TAB key.  (See advanced
  465.                features on how to change this hotkey to another key).
  466.                ROBIN!'s main menu displays the following options:
  467.  
  468.                   +------- ROBIN! Main Menu <time>-----+
  469.                   |                                    |
  470.                   |     1 - Logon.                     |
  471.                   |     2 - Upload a Quick Note  ALT-E |
  472.                   |     3 - Upload a Long File         |
  473.                   |     4 - Execute Script       ALT-S |
  474.                   |     5 - System Parameters          |
  475.                   |     6 - Open Print Buffer    ALT-D |
  476.                   |                                    |
  477.                   +---- Press Number Key To Select ----+
  478.  
  479.                All of ROBIN!'s hotkeys are done  by pressing first the ALT
  480.                key and then while it is still held down pressing another
  481.                key.  For ROBIN's main menu this is the TAB key.  You can
  482.                exit the main menu, and return to Prodigy, by pressing the
  483.                ESC key.  When you press ALT-TAB, the Prodigy service is
  484.                suspended, Robin!'s main menu will pop up over the Prodigy
  485.                screen.  You can then select a Robin! feature by pressing
  486.                the number key that corresponds to the number in the menu of
  487.                the feature you desire.  After you are finished with the
  488.                feature or if you press ESC, then Robin! will return you to
  489.                the Prodigy service.
  490.  
  491.  
  492.           ALT-X CANCELING ROBIN!'S ACTIONS
  493.  
  494.                At this point it may be a good idea to explain the ALT-X
  495.                hotkey.  This is a special ROBIN! hotkey that cancels any
  496.                ROBIN! script or command that is in progress.  This comes in
  497.  
  498.  
  499.  
  500.                ROBIN! 1.6 November 12, 1990                     page 7
  501.  
  502.  
  503.                handy when things seem to be going crazy.  Just press the
  504.                ALT-X hotkey and ROBIN! will stop sending stuff to Prodigy.
  505.  
  506.  
  507.           USING ROBIN! TO LOG ON TO PRODIGY
  508.  
  509.                Robin! can help you log on to the Prodigy service in two
  510.                ways.  First, ROBIN! can automatically log you on to Prodigy
  511.                when you first start Prodigy.  Second, when you are at
  512.                Prodigy's log on screen, and the cursor is positioned in the
  513.                Prodigy ID box, you can have Robin! automatically log you on
  514.                to Prodigy.  We will start with this second way so you can
  515.                understand where ROBIN! gets its IDs to logon on to Prodigy,
  516.                which you will need to understand before you can use ROBIN!
  517.                to log on automatically.
  518.  
  519.                You can reach ROBIN!'s log on menu by first pressing ALT-TAB
  520.                to bring up Robin!'s main menu.  Then you select the Logon
  521.                feature (1) from the menu.  This will display a list of up
  522.                to 6 Prodigy IDs and user names that is displayed as
  523.                follows:
  524.  
  525.                   +---------- Log On Prodigy -<time>--+
  526.                   |                                   |
  527.                   |   KEY   ID#   NAME                |
  528.                   |   ------------------------------  |
  529.                   |   1  ABCD00A  MY NAME             |
  530.                   |   2  ABCD00B  YOUR NAME           |
  531.                   |   3  ABCD00C  HIS NAME            |
  532.                   |   4  ABCD00D  THEIR NAME          |
  533.                   |                                   |
  534.                   |                                   |
  535.                   +------ Press key to Log On --------+
  536.  
  537.                You can then select one of these IDs by pressing the number
  538.                key that corresponds to the number of the ID you want to
  539.                use.   Robin! will then use that ID to log you on to
  540.                Prodigy.  These IDs, names and passwords are stored in a
  541.                file called ROBIN.DAT.  This file is a simple text file with
  542.                the following structure:
  543.  
  544.                   1st ID<CR>
  545.                   1st Password
  546.                   1st Username
  547.                   2nd ID
  548.                   2nd Password
  549.                   2nd Username
  550.                   3rd ...
  551.                   .
  552.                   .
  553.                   6th Username<CR>
  554.  
  555.  
  556.  
  557.                ROBIN! 1.6 November 12, 1990                     page 8
  558.  
  559.  
  560.                For example
  561.  
  562.                   WDTC55A
  563.                   GREEK
  564.                   JIMMY THE GREEK
  565.                   YTGH77A
  566.                   MONSTER
  567.                   HERMAN MUNSTER
  568.  
  569.                You can create such a file with a word processor that
  570.                creates simple ASCII file (non formatted), such as Microsoft
  571.                Word or Word Perfect.  You can also use DOS's EDLIN to
  572.                create this file.
  573.  
  574.                If you want you could create such a file from the DOS prompt
  575.                as follows:
  576.  
  577.                1) Change the current directory to your Prodigy directory.
  578.                   Type CD \PRODIGY  if this is the name of your Prodigy
  579.                   directory.
  580.                2) Type   COPY CON: ROBIN.DAT  and press the RETURN key,
  581.                3) Type in your Prodigy ID, press the RETURN key,
  582.                4) Type in your Prodigy Password, press the RETURN key,
  583.                5) Type in your name, and press the RETURN key,
  584.                6) then press the F6 function key, and press the RETURN key.
  585.  
  586.                This will create a file with one ID in it.  You can also
  587.                create or edit this file with the DOS EDLIN program or again
  588.                with most word processors that will let you save the file in
  589.                a regular text file or ASCII file (non formatted).
  590.  
  591.                The only requirements with this file other than the above
  592.                structure is that it must be called ROBIN.DAT, and it must
  593.                be in the same directory as your Prodigy(r) program (See
  594.                Command Line Switches on how to change this to a different
  595.                directory).
  596.  
  597.                You can make ROBIN! log you on to Prodigy(r) when you first
  598.                start Prodigy(r) by placing the number of the ID in the
  599.                ROBIN.DAT file that you want to logon with on the command
  600.                line when you start Prodigy(r).  For example, to log on
  601.                using Jimmy the Greek's ID in the above ROBIN.DAT file, at
  602.                the command line that starts prodigy you would type:
  603.  
  604.                   ROBIN 1
  605.  
  606.                To logon on with Herman Munsters ID you would type:
  607.  
  608.                   ROBIN 2
  609.  
  610.                For most, this will work fine.  For those of you who have
  611.                changed your PRODIGY.BAT file our have created a start up
  612.                BAT file of your own, you will need to read the section
  613.                Command Line Switches to figure out how to modify your BAT
  614.  
  615.  
  616.  
  617.                ROBIN! 1.6 November 12, 1990                     page 9
  618.  
  619.  
  620.                file to have PRODIGY.BAT file our have created a start up
  621.                BAT file of your own, you will need to read the section
  622.                Command Line Switches to figure out how to modify your BAT
  623.                file to have ROBIN! automatically log you on to Prodigy.
  624.  
  625.  
  626.           SENDING PRINTER OUTPUT TO A FILE
  627.  
  628.                Probably one of the most useful features of ROBIN! is the
  629.                ability to save messages and other information from Prodigy
  630.                in a text file on your computer.  ROBIN! does this by
  631.                capturing the information Prodigy let's you print to your
  632.                printer and put it into a file.  This is done by opening up
  633.                a print buffer.  Once opened, everything Prodigy tries to
  634.                send to the printer is grabbed by ROBIN! and placed in a
  635.                file.
  636.  
  637.                You can reach this feature while using Prodigy either from
  638.                ROBIN!'s main menu (Press ALT-TAB key) or using the ALT-D
  639.                hot key.  Selecting item 6 - Open Print Buffer, from
  640.                ROBIN!'s main menu, or pressing the ALT-D hot key displays
  641.                the following menu.
  642.  
  643.                   +----------- Print Capture Menu -<time>-----+
  644.                   | Enter filename for Download.              |
  645.                   | [+++++++++++++++++++++++++++++++++++++++] |
  646.                   |                                           |
  647.                   |                                           |
  648.                   |                                           |
  649.                   |                                           |
  650.                   |                                           |
  651.                   |                                           |
  652.                   |                                           |
  653.                   |                                           |
  654.                   +------------ Press Esc to Exit ------------+
  655.  
  656.  
  657.                You use this menu by just typing a filename to which you
  658.                wish to send printer output.  You can either type in a file
  659.                name as follows
  660.  
  661.                   NEWFILE.ASC
  662.  
  663.                or you can include a specific path as well
  664.  
  665.                   C:\MYFILES\NEWFILE.ASC
  666.  
  667.                You can also type in a search specification and Robin! will
  668.                display a directory of the files that match your search
  669.                specification.  For example, *.ASC will display a directory
  670.                of all the files in the current directory with an ASC
  671.                extension.  If there are more files than will fit in
  672.                ROBIN!'s menu box, then just press the RETURN key and
  673.                another set of filenames will be displayed.
  674.  
  675.  
  676.  
  677.                ROBIN! 1.6 November 12, 1990                     page 10
  678.  
  679.  
  680.                After you have finished typing the filename, press the
  681.                RETURN key.  If the file you have identified already exists,
  682.                then you will see the following message,
  683.  
  684.                   File exists. Press (A,O,N)
  685.                   [A]ppend,[O]verwrite,Enter [N]ew name?
  686.  
  687.                If you made a mistake and you do not want to use this file,
  688.                then press 'N' and ROBIN! will let you type in a new
  689.                filename.
  690.  
  691.                If this is the file you want to use, then you have two
  692.                choices.  First, you can choose to have ROBIN! add to the
  693.                end of this file any information you ask Prodigy to print.
  694.                Each time you tell Prodigy to print something, the file will
  695.                get bigger.  You can tell ROBIN! to do this by pressing the
  696.                'A' key for append at the [A]ppend,[O]verwrite [N]ew prompt.
  697.                Second, if you want to put the printer's output into a new
  698.                file, but use this filename, you would press the 'O' key for
  699.                [O]verwrite.  ROBIN! will then erase the old file (getting
  700.                rid of whatever was in the file) and start a new file with
  701.                the same name.  CAUTION! When you choose this option,
  702.                everything that was in the old file will be erased.
  703.  
  704.                Now if all this was a big mistake, and you just want to
  705.                start over, then rather than selecting 'A','O', or 'N',  at
  706.                this point if you press ESC, ROBIN! will take you back to
  707.                Prodigy(r).
  708.  
  709.                   +--- ROBIN! TIP ------------------------------------+
  710.                       Though it is not required, we advise that you                  |                                                   |
  711.                       use the .ASC extension on you downloaded files.                  |                                                   |
  712.                       The .ASC extension has been traditionally used                  |                                                   |
  713.                       to identify an ASCII file.  This is a file that                  |                                                   |
  714.                       contains only text and no formatting.  This is                  |                                                   |
  715.                       the type of file that ROBIN! creates.  Most                  |                                                   |
  716.                       word processors will let you use such a file,                  |                                                   |
  717.                       so you can edit downloaded files fairly easily.                  |                                                   |
  718.                   +---------------------------------------------------+
  719.  
  720.                Once a file has been specified all you have to do is tell
  721.                Prodigy(r) to print to the printer as you normally would.
  722.                However, instead of something being printed on your printer,
  723.                it is placed in the file you specified.  ROBIN! will give
  724.                you a little ticking sound as an audible feedback that your
  725.                information is being added to the print file.
  726.  
  727.                It is just as easy to stop sending information to the file
  728.                and tell Prodigy(r) to send it to the printer once again.
  729.                Just do the same thing you did before to display the Print
  730.                Capture Menu (Select 6 on ROBIN!'s main menu or press the
  731.                ALT-D hotkey).  This time you will see the following menu.
  732.  
  733.  
  734.  
  735.                ROBIN! 1.6 November 12, 1990                     page 11
  736.  
  737.  
  738.                   +------------ Print Capture Menu -----------+
  739.                   |                                           |
  740.                   |  To close ROBIN!`s print                  |
  741.                   |  capture Buffer, Press RETURN.            |
  742.                   |                                           |
  743.                   |  Press ESC if you DO NOT                  |
  744.                   |  want to close the Buffer!                |
  745.                   |                                           |
  746.                   |                                           |
  747.                   +------------- Press Esc to Exit -----------+
  748.  
  749.  
  750.                Now if you press RETURN, ROBIN! will close the print capture
  751.                buffer and your file, saving everything you would have
  752.                printed, and tells Prodigy to once gain send everything to
  753.                the printer from now on.  If you press ESC, then the print
  754.                buffer will stay open, and everything that normally would go
  755.                to your printer will still go into the same file as before.
  756.  
  757.                Normally, ROBIN! puts the information that would have gone
  758.                to your printer into the print buffer file in exactly the
  759.                same way as it would have appeared on your printer.  That is
  760.                in a 40 column format.  But that is not the only way ROBIN!
  761.                can do it.  ROBIN! can also put it into the file in an 80
  762.                column format, or a format that has no margins.  These two
  763.                other options are explained in more detail in the System
  764.                Parameters section below.
  765.  
  766.                LOG FILES               _________
  767.  
  768.                Robin has a feature that helps you maintain a series of log
  769.                files for your down loads.  When specifying a filename for a
  770.                down load file (as described above), if you type in
  771.  
  772.                LOG#
  773.  
  774.                and RETURN on the line you enter the filename, ROBIN! will
  775.                place in the filename field a filename that contains the
  776.                current date.  This name will be LOG<year><month>.<date>.
  777.                For example, on Christmas day, 1991, it would create a
  778.                filename as follows:
  779.  
  780.                LOG9112.25
  781.  
  782.                Once ROBIN! has created this logfile, you have three
  783.                options:
  784.  
  785.                  1) You can press RETURN and accept the filename ROBIN! has
  786.                     provided.  If a file with this name already exists,
  787.                     ROBIN! will let you overwrite or append to this file.
  788.                     Using this feature you can create a daily log file to
  789.                     which you can then just keep appending new downloads.
  790.  
  791.  
  792.  
  793.                ROBIN! 1.6 November 12, 1990                     page 12
  794.  
  795.  
  796.                  2) You could add a * to the end of the filename ROBIN! has
  797.                     provided and then press RETURN.  ROBIN! will then
  798.                     display all the files with a filename similar to the
  799.                     one just specified.
  800.  
  801.                  3) You can add another character or number to this file
  802.                     and press RETURN.  For example in the above Christmas
  803.                     Day file you could have added the letter 'A'
  804.  
  805.                     LOG9112.25A
  806.  
  807.                     Using the directory feature above first will show all
  808.                     the files of similar date to which you have added a
  809.                     character.
  810.  
  811.                This feature of ROBIN! was designed to provide you with a
  812.                quick way to maintain a dated log file system for your
  813.                message and data downloads.  From the DOS prompt you can
  814.                then sort and manage these files.
  815.  
  816.                   +--- ROBIN! TIP ------------------------------------+
  817.                       A variety of file management programs will                  |                                                   |
  818.                       allow you to view directories in some sorted                  |                                                   |
  819.                       order.  Each sorts files in slightly different                  |                                                   |
  820.                       ways.  You will need to experiment to see which                  |                                                   |
  821.                       way works best.  We would suggest sorting by                  |                                                   |
  822.                       filename, and then if possible by extension.                  |                                                   |
  823.                       We would also suggest you always add an 'A' to                  |                                                   |
  824.                       the end of the filename if it is the first one                  |                                                   |
  825.                       you have created for that date.                  |                                                   |
  826.                   +---------------------------------------------------+
  827.  
  828.  
  829.           FORMATTING PRINTER OUTPUT
  830.  
  831.                You can also use Robin! to format what is printed on your
  832.                printer in different formats.  Prodigy prints to your
  833.                printer normally in a 40 column format.  This means that
  834.                each line that is printed is 40 characters wide.  However,
  835.                Robin! can have your printer print lines 80 columns long.
  836.                This is done just as you would print to a file.  You bring
  837.                up the print capture menu.  When it asks for a file name you
  838.                type in PRN.  Robin! will say this file already exists.
  839.                Simply respond that you which to [O]verwrite the file.  Now
  840.                print using Prodigy as you normally do.  ROBIN! will capture
  841.                the info Prodigy tries to send to the printer, reformat it,
  842.                and then send it to the printer.  When you want to stop this
  843.                formatting, simply close the print buffer as described
  844.                previously.
  845.  
  846.                What you will find is that this also provides you with a
  847.                certain amount of buffering as well.  ROBIN! will not print
  848.                to the printer right away, but will wait until the buffer is
  849.                full, and then send a whole buffers worth.  You can force it
  850.  
  851.  
  852.  
  853.                ROBIN! 1.6 November 12, 1990                     page 13
  854.  
  855.  
  856.                to send everything to the printer by simply bringing up
  857.                ROBIN!'s main menu, this will tell ROBIN! to send everything
  858.                in the buffer to the printer.
  859.  
  860.  
  861.           UPLOADING A TEXT FILE TO PRODIGY MESSAGE CENTER OR BBS
  862.  
  863.                Not only does ROBIN! let you save information from
  864.                Prodigy(r) in a disk file, but ROBIN! also let's you send
  865.                information in a text (ASCII) disk file to Prodigy(r).  This
  866.                is done normally (though not absolutely) when you are
  867.                writing a message or replying to a message in the message
  868.                center or in a bulletin board.  This feature can not only be
  869.                accessed from ROBIN!'s main menu, but also with the ALT-E
  870.                hotkey.
  871.  
  872.                ROBIN! let's you upload text files in two ways, via a quick
  873.                note which is simply a 4 page message (or 6 pages if in the
  874.                bulletin board) or send a very long text file that is spread
  875.                over several messages (which can only be done from the
  876.                message center).
  877.  
  878.                Quick Notes               ___________
  879.  
  880.                A quick note is easy to send.  But the location that you are
  881.                at in prodigy is critical.  To send a quick note, you must
  882.                first move the cursor to the upper left hand corner of
  883.                Prodigy's word processor window.  This is where you normally
  884.                begin entering the text of your messages.  Once you are in
  885.                this location, then you can ask ROBIN! to send a text file
  886.                to Prodigy.  This can be done from ROBIN!'s main menu
  887.                (remember ALT-TAB) or by pressing the  ALT-E hot key.
  888.  
  889.                When you select option 2- Upload a Quick Note from ROBIN!'s
  890.                main menu, or if you press the ALT-E hotkey, you will see
  891.                the following menu:
  892.  
  893.                   +------ ROBIN! Quick Note Menu -<time>------+
  894.                   | Enter filename to Send.                   |
  895.                   | +++++++++++++++++++++++++++++++++++++++++ |
  896.                   |                                           |
  897.                   |                                           |
  898.                   |                                           |
  899.                   |                                           |
  900.                   |                                           |
  901.                   |                                           |
  902.                   |                                           |
  903.                   |                                           |
  904.                   +------------ Press Esc to Exit ------------+
  905.  
  906.  
  907.                You use this menu by simply typing the name of the text file
  908.                you want to send.  You can either type in a simple file name
  909.                as follows:
  910.  
  911.  
  912.  
  913.                ROBIN! 1.6 November 12, 1990                     page 14
  914.  
  915.  
  916.                   TEXTFILE.ASC
  917.  
  918.                or you can include a specific path as well
  919.  
  920.                   C:\MYFILES\TEXTFILE.ASC
  921.  
  922.                If you can not remember the name of the file you want to
  923.                send, you can also type in a search specification (EXAMPLE
  924.                *.ASC) and Robin! will display a directory of the files that
  925.                matches your search specification.  For example, *.ASC will
  926.                display a directory of all the files in the current
  927.                directory with an ASC extension.  If there are more files
  928.                than will fit in ROBIN!'s menu box, then just press the
  929.                RETURN key and another set of filenames will be displayed.
  930.  
  931.                After you have finished typing the filename, press the
  932.                RETURN key.  If the file you have identified does not exist,
  933.                ROBIN! will complain and ask you to type in a valid file
  934.                name.  At this point you can either press ESC to go back to
  935.                Prodigy(r) or you can type in another filename (or a search
  936.                specification as above).
  937.  
  938.                After you have identified the file you want to send, you
  939.                will see the following message:
  940.  
  941.                   +------ ROBIN! Quick Note Menu -<time>------+
  942.                   |                                           |
  943.                   |   Press ...                               |
  944.                   |                                           |
  945.                   |    1 if E-Mail                            |
  946.                   |    2 if Bulletin Board                    |
  947.                   |    3 if Script File                       |
  948.                   |                                           |
  949.                   |                                           |
  950.                   |                                           |
  951.                   |                                           |
  952.                   +------------ Press Esc to Exit ------------+
  953.  
  954.  
  955.                If you are using Prodigy's message center to send your
  956.                message (this is the personal email system) then press 1, if
  957.                you are using a bulletin board then press 2, if you are not
  958.                uploading at a message center or BBS, then press 3 (sounds
  959.                like a recorded phone message).  Once ROBIN! knows how to
  960.                send the message, it will then enter the message into
  961.                Prodigy just as if you typed it.  This will normally happen
  962.                fairly quickly.  If you selected options 1 or 2, ROBIN! will
  963.                page down to the next page as each page is full.  Once all
  964.                of your message has been entered, then you can work with it
  965.                just as if you had entered it by hand.  You can edit it, add
  966.                to it, and eventually send it by selecting the SEND button
  967.                on the Prodigy menu.
  968.  
  969.  
  970.  
  971.                ROBIN! 1.6 November 12, 1990                     page 15
  972.  
  973.  
  974.                When using quick notes, ROBIN! can only send one message.
  975.                If you are using the message center this means that it can
  976.                send only 4 pages, or 48 lines of 40 column text.  If you
  977.                are using the bulletin board you can send only 6 pages or 62
  978.                lines of text (1 7 line page and 5 11 line pages, strange
  979.                huh!).  Under both of this conditions, even if the file you
  980.                want to send is longer than the above, ROBIN! will stop
  981.                after it has reached the limits of one message.
  982.  
  983.                The third option above, '3 if script file' is different than
  984.                sending a message.  When sending a message ROBIN!
  985.                automatically enters your text, including the [NEXT] or
  986.                PgDns needed to page your message.  But under this third
  987.                option, ROBIN! does not do that.  It just reads the
  988.                characters from your file, and enters them as if you were
  989.                typing from the keyboard.  This option can be used to upload
  990.                IDs in mailing lists, items for purchase in grocery lists,
  991.                and other areas where entering text is appropriate.
  992.  
  993.                However, ROBIN! has a much more powerful file upload system
  994.                to send longer files to more people.
  995.  
  996.                Long Notes               __________
  997.  
  998.                As explained above, ROBIN!'s quick notes will not send all
  999.                of a text file if it is longer than one message.  However,
  1000.                ROBIN! can also send an entire text file, no matter how long
  1001.                it is (up to 25 messages) by breaking it up into multiple
  1002.                messages and sending all of these messages automatically.
  1003.                We call these long notes.
  1004.  
  1005.                Long notes can only be sent from Prodigy's message center,
  1006.                and only as a new message.  To send a long note, first you
  1007.                must select the WRITE menu option in the message center.
  1008.                This will place your cursor in the TO input box (this is
  1009.                where you enter peoples ID or address list name) above
  1010.                Prodigy's word processor.  If you have a list active,
  1011.                Prodigy will not show this box, but rather have the words
  1012.                DISTRIBUTION LIST displayed.  If you see this, you must go a
  1013.                delete the active list before ROBIN! can upload the file.
  1014.  
  1015.                Once the cursor is in this position and Prodigy is ready for
  1016.                input, you can tell ROBIN! to send a long note.  This
  1017.                feature can be accessed only from ROBIN!'s main menu.  Press
  1018.                ALT-TAB to display the main menu, and select option 3 -
  1019.                Upload Long Note.  This will display the following menu:
  1020.  
  1021.  
  1022.  
  1023.                ROBIN! 1.6 November 12, 1990                     page 16
  1024.  
  1025.  
  1026.                   +-------- ROBIN! Long File Menu <time>------+
  1027.                   | Enter filename to Send.                   |
  1028.                   | +++++++++++++++++++++++++++++++++++++++++ |
  1029.                   |                                           |
  1030.                   |                                           |
  1031.                   |                                           |
  1032.                   |                                           |
  1033.                   |                                           |
  1034.                   |                                           |
  1035.                   |                                           |
  1036.                   |                                           |
  1037.                   +------------ Press Esc to Exit ------------+
  1038.  
  1039.  
  1040.                You use this menu by typing the name of the text file you
  1041.                want to send.  You can either type in a simple file name as
  1042.                follows:
  1043.  
  1044.                   TEXTFILE.ASC
  1045.  
  1046.                or you can include a specific path as well
  1047.  
  1048.                   C:\MYFILES\TEXTFILE.ASC
  1049.  
  1050.                If you can not remember the name of the file you want to
  1051.                send, you can also type in a search specification (EXAMPLE
  1052.                *.ASC) and Robin! will display a directory of the files that
  1053.                matches your search specification.  For example, *.ASC will
  1054.                display a directory of all the files in the current
  1055.                directory with an ASC extension.  If there are more files
  1056.                than will fit in ROBIN!'s menu box, then just press the
  1057.                RETURN key and another set of filenames will be displayed.
  1058.  
  1059.                After you have finished typing the filename, press the
  1060.                RETURN key.  If the file you have identified does not exist,
  1061.                ROBIN! will complain and ask you to type in a valid file
  1062.                name.  At this point you can either press ESC to go back to
  1063.                Prodigy(r) or you can type in another filename (or a search
  1064.                specification as above).
  1065.  
  1066.                Once you have specified a file, robin will then prompt you
  1067.                to enter the ID (or address list name or address list in
  1068.                your address book) of the person to whom you want to send
  1069.                the list.  After you have entered this then ROBIN! will ask
  1070.                for the subject of your note.  After you have entered this,
  1071.                then ROBIN! will look at the file you have specified, sort
  1072.                it into multiple messages so it can send it in reverse order
  1073.                (ROBIN! displays a number for each message worth of text it
  1074.                finds in the file), and then ROBIN! will send your file.
  1075.  
  1076.                Since ROBIN! sends these messages in reverse order this
  1077.                means these messages will show up in people's mail box in
  1078.                the correct order.  ROBIN! gives each message the same
  1079.                subject title, but it uses the last 4 characters of the
  1080.  
  1081.  
  1082.  
  1083.                ROBIN! 1.6 November 12, 1990                     page 17
  1084.  
  1085.  
  1086.                subject line to number the messages.  This will help you and
  1087.                others keep track of their proper order.  It also becomes
  1088.                fairly obvious when you look in your mail box that the
  1089.                messages are part of one long message.
  1090.  
  1091.                When uploading a multiple message long file, ROBIN! will
  1092.                make Prodigy pause after the second and subsequent message
  1093.                uploads.  This is to give Prodigy time to catch up with its
  1094.                communications with the Host system.  This is needed to keep
  1095.                ROBIN! form cramming to much, to fast down Prodigy's throat.
  1096.                Prodigy has a tendency to gag when this is done.  While
  1097.                ROBIN! is making Prodigy pause, you will here a beeping (or
  1098.                tweeting or buzzing or some noise depending on the speed of
  1099.                your computer).  This is just to let you know that ROBIN! is
  1100.                still uploading your file.  If this pause seems to long,
  1101.                then you can use the System Menu to shorten (or lengthen)
  1102.                the time for this pause.
  1103.  
  1104.                Sending Long Notes to a List of People               ______________________________________
  1105.  
  1106.                ROBIN! can send long notes to more than one ID, up to 25,
  1107.                automatically.  ROBIN! can use a list or database of Prodigy
  1108.                IDs that you store in a disk file, and send a long note to
  1109.                each ID in the file.
  1110.  
  1111.                You can tell ROBIN! to do this by typing in the word LIST
  1112.                (Type the letters 'LIST'), when ROBIN! prompts you for the
  1113.                ID to whom you want to send the Long Note.  ROBIN! will then
  1114.                ask you to type in a file name for the list of IDs you want
  1115.                ROBIN! to send the long note (or you can enter a search
  1116.                specification).  ROBIN! will then go on and ask for a
  1117.                Subject, and then sort and send the file.  But know it will
  1118.                use Prodigy's list facility to send the long note to the IDs
  1119.                in your file.  ROBIN! can send this note to a maximum of 25
  1120.                people (regardless of how many are in the file).
  1121.  
  1122.                The structure of this list file is very flexible.  All that
  1123.                is required is that it be an ASCII file, that each ID be on
  1124.                a separate line which ends with a carriage return, the ID
  1125.                must be the first seven characters on the line, and the line
  1126.                can not have more than 255 characters total.  ROBIN! will
  1127.                ignore all the other characters on the line.  This means
  1128.                that for each ID you could include a name, address, phone
  1129.                number, what ever.  You could even keep these in a database,
  1130.                and simply print out the list to an ASCII file when you need
  1131.                it.
  1132.  
  1133.                Here are some examples of a ID lists:
  1134.  
  1135.                   ABCD01A Tim Bobcat's ID
  1136.                   DEFG01A My brother's ID
  1137.                   ZXYW01A Someone's ID but I am not sure whose
  1138.  
  1139.  
  1140.  
  1141.                ROBIN! 1.6 November 12, 1990                     page 18
  1142.  
  1143.  
  1144.                   ABCD01A,Big Bear,1103 Cave Road, Yellowstone, WY, 99099
  1145.                   ZZXZ99F,Little Beaver,The Lake,Craig,CO,99089
  1146.  
  1147.  
  1148.                When ROBIN! is uploading a list, you will here it beeping
  1149.                for a while after each list.  This is normal.  At this point
  1150.                ROBIN! has forced prodigy to pause.  This beeping let's you
  1151.                know that ROBIN! is still active, and your upload is
  1152.                proceeding as it should.
  1153.  
  1154.                   +--- ROBIN! TIP ------------------------------------+
  1155.                       Though it is not required, we advise that you                  |                                                   |
  1156.                       use the .LST extension on your ID list database                  |                                                   |
  1157.                       files.  This will be a good reminder when you                  |                                                   |
  1158.                       want to do a directory search for list files.                  |                                                   |
  1159.                       You can also give a message and its list the                  |                                                   |
  1160.                       same name, and use the ASC and LST extensions.                  |                                                   |
  1161.                   |                                                   |
  1162.                       WARNING: ROBIN! does very little error checking                  |                                                   |
  1163.                       while reading this file.  Abnormal formats will                  |                                                   |
  1164.                       result in abnormal actions by ROBIN! and                  |                                                   |
  1165.                       Prodigy.                  |                                                   |
  1166.                   +---------------------------------------------------+
  1167.  
  1168.                Using Your Word Processor or Editor               ___________________________________
  1169.  
  1170.                Prodigy's online word processor is not the best (not the
  1171.                worst either) and provides almost no advanced word
  1172.                processing tools.  This makes it a pain to compose any type
  1173.                of note other than a simple 'Hello'.  So being able to use
  1174.                your own (or someone else's if that be the case) makes it a
  1175.                lot easier to compose messages.  Here are some hint's at
  1176.                using your word processor or editor to compose notes and
  1177.                then upload them with ROBIN!.
  1178.  
  1179.                1) If you have a Word Processor, let it and ROBIN! do the
  1180.                work.  Do not worry about putting a RETURN or Carriage
  1181.                Return at the end of each line.  Let your word processor
  1182.                word wrap your paragraphs and put a RETURN only at the end
  1183.                of each paragraph.
  1184.  
  1185.                2) Save your file as a pure vanilla text or ASCII file.
  1186.                Most word processors DO NOT do this by default.  You
  1187.                generally will need to save your file in a special way.
  1188.                Check your manual for how to save your file as an
  1189.                UNFORMATTED text or ASCII file.
  1190.  
  1191.                3) If your using an Editor instead of a Word processor
  1192.                (Sidekick, Brief, and Edlin are editors) then it is likely
  1193.                that it does not do word wrap, but rather puts a RETURN or
  1194.                Carriage Return at the end of each line.  If this is the
  1195.                case, then you will get the best results if you set it's
  1196.                margins at 78 columns.
  1197.  
  1198.  
  1199.  
  1200.                ROBIN! 1.6 November 12, 1990                     page 19
  1201.  
  1202.  
  1203.  
  1204.           USING ROBIN! SCRIPTS TO AUTOMATE PRODIGY SERVICES
  1205.  
  1206.                Though ROBIN! has many useful features, the primary reason
  1207.                it was written was to provide a keyboard macro feature.  The
  1208.                next section describes what is a script (or macro) and how
  1209.                they work.  Those that are familiar with macros and scripts
  1210.                might want to skip this section.
  1211.  
  1212.                What is a ROBIN! script?               ________________________
  1213.  
  1214.                Essentially ROBIN!'s scripts provide a way to make a
  1215.                recording of keystrokes that you would normally just type
  1216.                and play them back later.
  1217.  
  1218.                How do you use them while online with Prodigy?               ______________________________________________
  1219.  
  1220.                ROBIN!'s script can be started from ROBIN!'s main menu or
  1221.                with the ALT-S hotkey.  When you select option 4 - Execute
  1222.                Script from ROBIN!'s main menu, or you press the ALT-S
  1223.                hotkey, you will see a menu that looks similar to the
  1224.                following.
  1225.  
  1226.                   +----------- Robin! Script Menu <time>------+
  1227.                   |   A - MESSAGES         I -                |
  1228.                   |   B - KIDS CLUB        J -                |
  1229.                   |   C - COMP CLUB        K -                |
  1230.                   |   D - KIDS BB          L -                |
  1231.                   |   E - COMP BB          M -                |
  1232.                   |   F - PRN NEXT         N -                |
  1233.                   |   G - BB MAIL          O -                |
  1234.                   |   H -                  P -                |
  1235.                   +------ Press Key to Execute Script --------+
  1236.  
  1237.  
  1238.                Each of these sixteen letters and its associated title
  1239.                represent a series of keystrokes that have been recorded and
  1240.                can be played back.  You can play back the keystrokes by
  1241.                simply pressing the letter that corresponds to the script
  1242.                you want to playback.  When you use ROBIN! for the first
  1243.                time, you should have the above scripts available.  The
  1244.                following section explains what each of these scripts does,
  1245.                and where to use them.
  1246.  
  1247.                WRITE - Where: Use this almost anywhere at anytime (We have
  1248.                not found a place where this does not work).  What: This
  1249.                script will take you to the message center, select Write
  1250.                Message, and leave you in the TO: box.
  1251.  
  1252.                MESSAGES - Where: Use this almost anywhere at anytime (We
  1253.                have not found a place where this does not work).  What:
  1254.                This script will take you over to the message center and
  1255.                leave you in your mail box.
  1256.  
  1257.  
  1258.  
  1259.                ROBIN! 1.6 November 12, 1990                     page 20
  1260.  
  1261.  
  1262.                KIDS CLUB - Where: Use this almost anywhere at anytime (We
  1263.                have not found a place where this does not work).  What:
  1264.                This script will take you over to the Kids Club's main menu.
  1265.  
  1266.                COMP CLUB - Where: Use this almost anywhere at anytime (We
  1267.                have not found a place where this does not work).  What:
  1268.                This script will take you over to the Computer Club's main
  1269.                menu.
  1270.  
  1271.                KIDS BB - Where: Use this almost anywhere at anytime (We
  1272.                have not found a place where this does not work).  What:
  1273.                This script takes you over to the Kids Club Bulletin Board.
  1274.  
  1275.                COMP BB - Where: Use this almost anywhere at anytime (We
  1276.                have not found a place where this does not work).  What:
  1277.                This script takes you over to the Computer Club Bulletin
  1278.                Board.
  1279.  
  1280.                BB MAIL - Where: Use this script with the Bulletin boards.
  1281.                All the bulletin boards have an option that allows you to
  1282.                search for notes that are from or to a particular ID.  To
  1283.                use this script first go a bulletin board (Use a ROBIN!
  1284.                script!), then at the bulletin board's main menu, use this
  1285.                script.  What: this script will enter your ID and ask Prod
  1286.                to search for messages to you.
  1287.  
  1288.                PRN NEXT - Where: While you are reading a message from your
  1289.                private mail box, you can use this macro to print the
  1290.                current message and go to the next message in your box.
  1291.                From anywhere on the Prodigy read message screen this macro
  1292.                should work.  What: Goes to the options box, prints the
  1293.                message, and the selects the next message option.
  1294.  
  1295.                These default scripts are ones that we have found to be
  1296.                generally useful to every one.  In the appendix is a list of
  1297.                scripts that you may find convenient as well.
  1298.  
  1299.                How do you create them?               _______________________
  1300.  
  1301.                ROBIN! scripts are created using a special program while off
  1302.                line from Prodigy.  This is program is the ROBIN! Script
  1303.                Code Compiler (RSCC).  Scripts start out as text file
  1304.                containing lists of keystrokes.  RSCC compiles these into a
  1305.                special format that ROBIN! then uses.  Because the ROBIN!
  1306.                script language and script compiler have so many options,
  1307.                this document has a whole chapter devoted to creating
  1308.                scripts.  To create your own scripts refer to the chapter
  1309.                ROBIN! Script Writer and Language.
  1310.  
  1311.                What are some of the things you can do with Scripts?               ____________________________________________________
  1312.  
  1313.                As far as we can tell, anything that you can do from the
  1314.                keyboard while using prodigy, can be put into a script.
  1315.                However, scripts are best used to automate common tasks.
  1316.  
  1317.  
  1318.  
  1319.                ROBIN! 1.6 November 12, 1990                     page 21
  1320.  
  1321.  
  1322.                Scripts can improve the productivity and ease of  use of
  1323.                Prodigy by automating how you get to the features of Prodigy
  1324.                you use most.  This way with just a few keystrokes you can
  1325.                access prodigy features that normally would take a lot of
  1326.                keystrokes.
  1327.  
  1328.                You will also find that a script's keystrokes actually get
  1329.                entered faster than you could type them.  This is because
  1330.                ROBIN! knows exactly when Prodigy is ready for another
  1331.                keystroke.
  1332.  
  1333.                Also, since ROBIN! provides you with a menu of scripts to
  1334.                choose from, it makes it easier to remember how to access
  1335.                various features.
  1336.  
  1337.                Currently, you can not use scripts to access or automate any
  1338.                of ROBIN!'s other features.  But we are working on that.
  1339.  
  1340.  
  1341.           THE SYSTEM MENU
  1342.  
  1343.                ROBIN! has a variety of defaults that it uses for its
  1344.                various functions.  These include default directories,
  1345.                system values, and menu options.  Occasionally you may find
  1346.                it useful to change these defaults for a short period of
  1347.                time.  The system menu provides a way to do so.  The
  1348.                following describes several of these defaults, and how to
  1349.                change them.  IMPORTANT: changes made here are not
  1350.                permanent, and will revert back to the default next time you
  1351.                run ROBIN!.  These defaults can be changes permanently using
  1352.                ROBIN!'s configuration program RCONFIG, which is described
  1353.                in the Advanced Features section of this document.
  1354.  
  1355.                Using The Dialog Box               ____________________
  1356.  
  1357.                There are three types of fields in this dialog box, text
  1358.                entry fields, numeric entry fields, and toggle fields.  Text
  1359.                entry fields let you enter text.  Numeric entry fields let
  1360.                you enter a number.  The toggle fields let you toggle the
  1361.                field between 2 or more set states (like a switch) using the
  1362.                SPACE bar or the + key.
  1363.  
  1364.                Printer Format               ______________
  1365.  
  1366.                The printer format can be set to one of three states, 40
  1367.                Column mode, 80 Column mode, and No Format mode.  In the 40
  1368.                Column mode, ROBIN! will insert a Carriage Return/ Line Feed
  1369.                after every 40 columns of text.  In the 80 Column mode
  1370.                ROBIN! will insert a Carriage Return/Line Feed only after 80
  1371.                columns.  In the no format mode ROBIN! will use as few
  1372.                Carriage Return/Line Feeds as possible.
  1373.  
  1374.  
  1375.  
  1376.                ROBIN! 1.6 November 12, 1990                     page 22
  1377.  
  1378.  
  1379.                System Path               ___________
  1380.  
  1381.                This is the default pathname that ROBIN! will use when
  1382.                creating or looking for upload and download files you
  1383.                specify.  You should enter a path only, and it should end
  1384.                with the '\' character.
  1385.  
  1386.                Script Display               ______________
  1387.  
  1388.                This determines if the Script Menu will be displayed when
  1389.                you press the ALT-S hotkey.  After you become familiar with
  1390.                your Scripts, you will likely not need to see the menu to no
  1391.                which letter corresponds to the script you want to use.  If
  1392.                this field is toggled Yes (default) then when you press ALT-
  1393.                S the script menu will be displayed.  But if it is NO, then
  1394.                the script menu will NOT be displayed.  In this mode you
  1395.                just press ALT-S and the key for the macro you want to use.
  1396.                This is typically faster than waiting for the menu.  You can
  1397.                always display the script menu from ROBIN!'s main menu
  1398.                regardless of how this field is toggled.
  1399.  
  1400.                Node Wait Time               ______________
  1401.  
  1402.                As discussed in the section on long file uploads, ROBIN!
  1403.                makes Prodigy wait between file uploads.  This field has the
  1404.                value that defines how long the interval that ROBIN! makes
  1405.                Prodigy wait will be. This value can be anything from 1 to
  1406.                255.  By watching the lights on your modem, you can tell if
  1407.                Prodigy finishes before ROBIN!'s pause expires.  If it
  1408.                finishes substantially sooner, you can lower this value to
  1409.                speed up your uploads.  If you are having problems with your
  1410.                long file uploads, you might try making this value longer.
  1411.  
  1412.  
  1413.  
  1414.           ROBIN! SCRIPT WRITER AND LANGUAGE.          ROBIN! SCRIPT WRITER AND LANGUAGE.
  1415.  
  1416.  
  1417.                ROBIN!'s scripts provide a way to reduce the keystrokes you
  1418.                need to type to use Prodigy's services.  In their simplest
  1419.                form, a ROBIN! script can be thought of as a recording of
  1420.                keystrokes that can be played back when you want to use it.
  1421.                ROBIN's scripts can also be used to insert the time, date,
  1422.                user id, or your name.  ROBIN!'s scripts are assigned to a
  1423.                key A through J, which can be selected from the script menu
  1424.                or used as hotkeys.
  1425.  
  1426.                Creating ROBIN! scripts is a three step process.  First you
  1427.                have to decide exactly what you want the script to do and
  1428.                write down all the keys you would have to press to do that
  1429.                on Prodigy.  Second you have to record these keystrokes in a
  1430.                ROBIN! script text file.  Lastly you have to compile this
  1431.                script text file in a form that the ROBIN! program can read
  1432.  
  1433.  
  1434.  
  1435.                ROBIN! 1.6 November 12, 1990                     page 23
  1436.  
  1437.  
  1438.                and use.  Any word processing or editor that supports plain
  1439.                ASCII files can be used create a script text file.
  1440.  
  1441.  
  1442.           HOW TO START THE COMPILER
  1443.  
  1444.                ROBIN!'s Script Code Compiler reads script text files and
  1445.                converts them into a format that can then be used by the
  1446.                ROBIN! program.  The compiler is started by typing RSCC
  1447.                followed by the file name of your script text file.  For
  1448.                example:
  1449.  
  1450.                   RSCC MYSCRIPT.ASC
  1451.  
  1452.                Here the script compiler will start, and use the file
  1453.                MYSCRIPT.ASC
  1454.  
  1455.                The script compiler will generate two files (if compiled
  1456.                successfully), an RSF file and a RSL file.  The RSF file is
  1457.                a file format that is read by the ROBIN! program when it is
  1458.                first executed.  The RSL file is a listing of the results of
  1459.                the compile.  If there were errors during compilation, these
  1460.                errors will be in this listing file.
  1461.  
  1462.  
  1463.           HOW TO WRITE A SCRIPT FILE
  1464.  
  1465.                To write a ROBIN! script, you must first write a ROBIN!
  1466.                script text file.  This script text file contains a series
  1467.                of lines, each representing a different keystroke or group
  1468.                of keystrokes.  This file is then compiled using the ROBIN!
  1469.                script code compiler, and converts it into a special file
  1470.                that ROBIN! will load when it is run.  ROBIN! then uses the
  1471.                information in this file to playback the keystrokes you want
  1472.                for each script.
  1473.  
  1474.                The best way to begin writing a script file is to fire up
  1475.                Prodigy.  Decide what you want your script to do.  Then
  1476.                starting from a known point, press the keys needed
  1477.                accomplish what you want your script to do, writing down the
  1478.                keys you press.  You can then place these keystrokes in a
  1479.                ROBIN! script file.
  1480.  
  1481.                Writing simple scripts is fairly straight forward  The best
  1482.                way to master simple script writing is to look at the
  1483.                examples and write some of your own.  Then begin
  1484.                experimenting.  Once you have mastered simple scripts, then
  1485.                you can move on to more advanced script writing.  Writing
  1486.                advanced scripts is half art and half observation.  For
  1487.                example, writing a script that prints a message seems fairly
  1488.                easy.  But writing a script to print a message, NO MATTER
  1489.                WHERE YOU EXECUTE IT FROM, is both and art and requires
  1490.                close scrutiny of how Prodigy works.  In this limited space,
  1491.                we could not provide a thorough discussion of how all of
  1492.  
  1493.  
  1494.  
  1495.                ROBIN! 1.6 November 12, 1990                     page 24
  1496.  
  1497.  
  1498.                Prodigy's services work.  After all, Prodigy has not even
  1499.                done that in their own documentation!  But we can include
  1500.                some insight into some key aspects of prodigy and some
  1501.                hints.
  1502.  
  1503.                One of the most difficult things about writing a script is
  1504.                knowing where you will be in Prodigy when you start a
  1505.                script.  This may seem impossible at first.  In fact you can
  1506.                not guarantee where the  script will start.  However, with
  1507.                in limits, there are things you can do to get to a common
  1508.                starting point.
  1509.  
  1510.                Generally it is reasonable to assume that you will be at a
  1511.                certain level when executing certain scripts.  For example,
  1512.                it may be safe to assume that if you want to print a
  1513.                message, you will be reading the message.  You may not know
  1514.                where the cursor may be on that screen (which is ok as we
  1515.                will show later) but you may assume you are somewhere on the
  1516.                read message screen.  Other times such assumptions may not
  1517.                be valid.  But there are ways that you can almost guarantee
  1518.                that you can get to specific spot that will always be the
  1519.                same.
  1520.  
  1521.                Jump Menu - One way is to use the jump menu.  The F6 will
  1522.                almost always bring up the jump menu.  The only exception is
  1523.                if you have a process under that requires a response.  For
  1524.                example you are composing a message, but have not sent it
  1525.                yet.
  1526.  
  1527.                Once you can establish you are on a certain screen, there
  1528.                are also ways to get to a know position on the screen, no
  1529.                matter where you are on the screen.  The END and Home keys
  1530.                are extremely useful for this.  Usually (we have not found a
  1531.                case but one may exist where this is not true) The Home and
  1532.                End keys will take the cursor to a very specific place on
  1533.                every screen.  Once you are in this position, then you can
  1534.                use the script to move to the button or entry box you need.
  1535.  
  1536.  
  1537.           SCRIPT FILE STRUCTURE
  1538.  
  1539.                First, it is VERY IMPORTANT to note that every script file
  1540.                you compile, must contain the system scripts.  These are the
  1541.                scripts located in a file RSYS.RSF (Source for these is
  1542.                RSYS.ASC).  The script file compiler will automatically
  1543.                include these scripts, but you should never delete or modify
  1544.                the system scripts in this file.  If you do, ROBIN! will not
  1545.                operate properly.
  1546.  
  1547.                Each script in a Script text file must begin with a start
  1548.                marker and must end with a stop marker,.  A start marker is
  1549.                the word START inside two vertical dash characters, here
  1550.                called the Vbars.  A stop marker is the word STOP inside two
  1551.                Vbars.  Everything outside of these markers is ignored,
  1552.  
  1553.  
  1554.  
  1555.                ROBIN! 1.6 November 12, 1990                     page 25
  1556.  
  1557.  
  1558.                everything inside these markers is considered part of the
  1559.                script.  Comments can be inserted between a  start and stop
  1560.                marker if they are preceded by a semicolon (;).
  1561.  
  1562.                Each script must have the script key code as the first line
  1563.                following the start marker.  Valid key codes are A - P with
  1564.                A through P accessible as user scripts.  Each key id is then
  1565.                followed on the next line with a script name.
  1566.  
  1567.                Each of the lines from the script name to the stop marker
  1568.                presents actual keystrokes or Script commands (comments
  1569.                excepted).  This provides for a general structure as follows
  1570.  
  1571.                   ;MAIL SCRIPT
  1572.                   |START|
  1573.                   A
  1574.                   GO MAIL
  1575.                   ; Bring Up Jump Box
  1576.                   |F6|
  1577.                   COMMUNICATION
  1578.                   .
  1579.                   .  Other Keys or Commands
  1580.                   .
  1581.                   |STOP|
  1582.  
  1583.                This is a script that is assigned to the A key and is called
  1584.                GO MAIL (GO MAIL is what you will see in ROBIN!'s script
  1585.                menu).  It brings up the jump table, and enters the word
  1586.                communication.
  1587.  
  1588.                There are several scripts near the end of the RSCRIPT.ASC
  1589.                script text file.  These scripts should not be modified and
  1590.                must be included in any future script file you may create.
  1591.  
  1592.  
  1593.           PRODIGY WORKINGS
  1594.  
  1595.                The following section describe some if the workings of
  1596.                Prodigy is a manner that makes it easier to develop scripts
  1597.                to meet your needs.
  1598.  
  1599.  
  1600.  
  1601.                COMMAND LINE (Bottom of Prodigy's screen)
  1602.  
  1603.                These are the hotkeys available when not editing a message.
  1604.  
  1605.                   B - Backup (same as F9)    L - Look
  1606.                   E - Exit                   M - Menu
  1607.                   G - Guide via Jump Box     N - Next
  1608.                   H - Help (same as F1)      T - Tools via Jump Box
  1609.                   I - Index via Jump Box     V - ViewPath
  1610.                   J - Jump (same as F6)      
  1611.  
  1612.  
  1613.  
  1614.                ROBIN! 1.6 November 12, 1990                     page 26
  1615.  
  1616.  
  1617.                FUNCTION KEYS
  1618.  
  1619.                   F1  - Help                F2  -                
  1620.                   F3  - Path List           F4  -
  1621.                   F5  - Menus               F6  - Jump Table
  1622.                   F7  -                     F8  - Find
  1623.                   F9  - Backup              F10 - Review List
  1624.  
  1625.  
  1626.                HOME and END Key Performance
  1627.  
  1628.                Place                    Key       Action
  1629.  
  1630.                -----------------        ------    -----------------------
  1631.  
  1632.                Message Center -         Home      Page # box
  1633.                Mail Box                 End       Print button
  1634.  
  1635.  
  1636.  
  1637.                Message Center -         Home      TO: box
  1638.                Write Message            End       Options button
  1639.  
  1640.  
  1641.  
  1642.                Message Center -         Home      Reply button
  1643.                Read A Message           End       Options button
  1644.  
  1645.  
  1646.  
  1647.                Message Center -         Home      Subject box
  1648.                Write A Reply            End       Options button
  1649.  
  1650.  
  1651.  
  1652.                Bulletin Board -         Home      Bulletin# box Reply# box
  1653.                Read Bulletin            End       Options Button
  1654.  
  1655.  
  1656.  
  1657.                Bulletin Board -         Home      FROM: id box
  1658.                Selection By ID          End       Continue button
  1659.  
  1660.  
  1661.  
  1662.                Bulletin Board -         Home      Month Browse Box
  1663.                Browse Bulletins         End       Options button
  1664.  
  1665.  
  1666.  
  1667.                ROBIN! 1.6 November 12, 1990                     page 27
  1668.  
  1669.  
  1670.  
  1671.           THE LANGUAGE
  1672.  
  1673.                ROBIN!'s script language can be divided into three groups,
  1674.                key macros, string macros, and commands.  We call them
  1675.                macros, because each causes one or more characters to be
  1676.                pushed into the script keyboard buffer.  Key macros push a
  1677.                particular key stroke, just as it would be typed at the
  1678.                keyboard.  String macros insert a series of characters into
  1679.                the script buffer.  Commands actually insert nothing into
  1680.                the script buffer.  Commands tell ROBIN! to preform some
  1681.                action, which will usually insert something in the script
  1682.                buffer.
  1683.  
  1684.                KEY MACROS
  1685.  
  1686.  
  1687.                RETURN  The ENTER keys      F1    F1 Function Key
  1688.                ESC     Escape Key          F2    F2 Function Key
  1689.                BS      Back Space Key      F3    F3 Function Key
  1690.                DEL     Delete Key          F4    F4 Function Key
  1691.                INS     Insert Key          F5    F5 Function Key
  1692.                HOME    Home Key            F6    F6 Function Key
  1693.                END     End Key             F7    F7 Function Key
  1694.                PGUP    Page Down Key       F8    F8 Function Key
  1695.                PGDN    Page Up Key         F9    F9 Function Key
  1696.                TAB     Tab Key             F10   F10 Function Key
  1697.                UP      Up Cursor Key       U     Up Cursor Key
  1698.                DOWN    Down Cursor Key     D     Down Cursor Key
  1699.                RIGHT   Right Cursor Key    R     Right Cursor Key
  1700.                LEFT    Left Cursor Key     L     Left Cursor Key
  1701.  
  1702.                STRING MACROS
  1703.  
  1704.                LOGPASS   Inserts the Password for the Current ID logged on
  1705.                          by ROBIN!
  1706.                LOGNAME   Inserts the Name for the Current ID Logged on by
  1707.                          ROBIN!
  1708.                LOGID     Inserts the ID of the current ID logged on by
  1709.                          ROBIN!
  1710.                TIME      Will insert the current time as if typed from the
  1711.                          keyboard
  1712.                DATE      Will insert the current date as if typed from the
  1713.                          keyboard.
  1714.  
  1715.                SCRIPT COMMANDS
  1716.  
  1717.                RESPONSE  This is used to respond to a Prodigy Button.
  1718.                          Similar to using the Return key when the active
  1719.                          cursor is on a Prodigy button.  This should be
  1720.                          used rather than the RETURN key macro to respond
  1721.                          positively to a Prodigy Button.
  1722.  
  1723.  
  1724.  
  1725.                ROBIN! 1.6 November 12, 1990                     page 28
  1726.  
  1727.  
  1728.                CALL      Used to call another script.  Syntax |CALL #|
  1729.                          where # is the letter of the script to be
  1730.                          installed.
  1731.                WAIT      Causes Prodigy to pause for a qtr of a second or
  1732.                          less.  Often useful when a script overruns
  1733.                          Prodigy's ability to respond in a timely fashion.
  1734.                          For example, some prodigy features take so long to
  1735.                          respond that Prodigy may attempt to clear the
  1736.                          keyboard buffer several times.  This helps to
  1737.                          prevent Prodigy from clear the rest of the script.
  1738.                          Syntax is |WAIT #| where # is a number 1 to 255
  1739.                          and represents how long to wait.
  1740.                SETID     Sets the current number that ROBIN! uses to look
  1741.                          up the LOGID, LOGPASS, and LOGNAME.  Syntax is
  1742.                          |SETID #| where # is a number 1 to 6 that
  1743.                          corresponds to the ID in the ROBIN.DAT file you
  1744.                          want to use.
  1745.                PAUSE     This tells ROBIN! to make Prodigy pause for a
  1746.                          while.  Very useful when sending a lot to prodigy.
  1747.                          Syntax, |PAUSE #| where # is a number that tells
  1748.                          ROBIN! how long to pause.  Pause can cause a delay
  1749.                          of up to several minutes.  Exactly how long # will
  1750.                          make ROBIN! pause is dependent on the speed of
  1751.                          your computer.
  1752.  
  1753.  
  1754.  
  1755.                ROBIN! 1.6 November 12, 1990                     page 29
  1756.  
  1757.  
  1758.  
  1759.           ADVANCED FEATURES          ADVANCED FEATURES
  1760.  
  1761.  
  1762.  
  1763.           COMMAND LINE SWITCHES
  1764.  
  1765.                There are several system level features you can change or
  1766.                activate using command line switches when you start robin.
  1767.  
  1768.  
  1769.                A=<n>  Automatic Login;
  1770.  
  1771.                This feature allows you to have ROBIN! automatically log you
  1772.                on to Prodigy when it first starts.  Place on the command
  1773.                line 'A=' followed by the number that represents the order
  1774.                of the ID in ROBIN.DAT you want to log on with.  For example
  1775.                if you had a ROBIN.DAT file as follows:
  1776.  
  1777.                   ZAXB01A
  1778.                   PASSWORD
  1779.                   MY NAME
  1780.                   ZAXB01B
  1781.                   PASSWORD
  1782.                   SPOUSE
  1783.  
  1784.                and you wanted to logon with the id ZAXB01B, then you would
  1785.                include in the command line for ROBIN!
  1786.  
  1787.                   ROBIN! a=2
  1788.  
  1789.                Which would use the second ID set in ROBIN.DAT to
  1790.                automatically logon to Prodigy.
  1791.  
  1792.                Now the ROBIN.BAT batch file has this set up for you.  When
  1793.                running ROBIN! from this batch file, simply specify the
  1794.                number on the command line as follows:
  1795.  
  1796.                   ROBIN 1
  1797.  
  1798.                V=<video type>  Set Video Mode for Prodigy.
  1799.  
  1800.                This is normally a switch you will not need to use, but must
  1801.                be specified each time Robin! is run.  This tells ROBIN! the
  1802.                video mode that Prodigy will be using.  Here are the
  1803.                possible options
  1804.  
  1805.                      V=C is for CGA
  1806.                      V=E is for EGA (or VGA)  320 x 200 mode
  1807.                      V=H is for Hercules
  1808.                      V=P is for Multigraphics Array
  1809.                      V=M is for EGA (or VGA) Ver 3 640 x 200 mode
  1810.                      V=U is for EGA (or VGA) Ver 3 640 x 350 mode
  1811.                      V=V is for VGA Ver 3 640 x 480 mode
  1812.  
  1813.  
  1814.  
  1815.                ROBIN! 1.6 November 12, 1990                     page 30
  1816.  
  1817.  
  1818.  
  1819.                D=<pathname>  Path to all ROBIN! scratch files
  1820.  
  1821.                This switch can be used to identify an alternative path for
  1822.                ROBIN!'s temporary files.  If you have a RAM drive,
  1823.                specifying a path to this RAM drive will improve the
  1824.                performance of ROBIN!  This path must end in a /.  Example:
  1825.                F:/
  1826.  
  1827.  
  1828.           ROBIN! IN THE WINDOW (WINDOWS 3)
  1829.  
  1830.                ROBIN! will work with Prodigy under Windows version 3.  When
  1831.                ROBIN! installed itself on your hard disk, it copied three
  1832.                files into your Prodigy directory,
  1833.  
  1834.                   ROBIN!.PIF
  1835.                   ROBIN!.ICO
  1836.                   ROBIN!.GRP
  1837.  
  1838.                These files will allow you to use ROBIN! with Windows 3.  To
  1839.                setup ROBIN! for Windows, follow these steps:
  1840.  
  1841.                  1) Copy (or move) the above files from your Prodigy
  1842.                     directory to your Windows directory.
  1843.  
  1844.                  2) Now exit and restart Windows.  Windows will now
  1845.                     recognize the ROBIN! file group.  Either a ROBIN! file
  1846.                     group icon should be in your Progam Manager window or
  1847.                     the ROBIN! group window should be open.  If it is not,
  1848.                     double click on the ROBIN! group icon.
  1849.  
  1850.                  3) You should now see the ROBIN! program icon (tweet tweet
  1851.                     little Robin).  You can now copy or move this icon to
  1852.                     any group you wish to keep it.  Refer to the Windows
  1853.                     Manual if you do not know how.
  1854.  
  1855.                  4) Evoke the PIF editor and open the file ROBIN!.PIF.
  1856.  
  1857.                  5) Change the directory field to the directory in which
  1858.                     you have prodigy installed.  Also, add to the command
  1859.                     line field an autologon value (See autologon).
  1860.  
  1861.                  6) Save the ROBIN!.PIF file, then exit the PIF editor.
  1862.  
  1863.                  7) Now you should be able to double click on the ROBIN!
  1864.                     icon to start Prodigy with ROBIN!.
  1865.  
  1866.                If you have enough RAM (4mb seems sufficient) you can switch
  1867.                out of Prodigy and back to Windows safely by pressing ALT-
  1868.                ESC and switch back to Prodigy with ALT-R.
  1869.  
  1870.  
  1871.  
  1872.                ROBIN! 1.6 November 12, 1990                     page 31
  1873.  
  1874.  
  1875.  
  1876.           ROBIN! CONFIGURATION PROGRAM RCONFIG.EXE
  1877.  
  1878.                ROBIN! has a configuration program that allows certain
  1879.                system defaults to be changed permanently in the ROBIN!.EXE
  1880.                file.  To start this program at the DOS command line simply
  1881.                type
  1882.  
  1883.                   RCONFIG
  1884.  
  1885.                This program will display the values of several default
  1886.                parameters, and will allow you to change the value of each.
  1887.                These include the default path for ROBIN! scratch files (see
  1888.                D switch  above), the default path used for uploads and
  1889.                print files, the node wait time (See System menu) and the
  1890.                Script Display value (See System Menu).
  1891.  
  1892.  
  1893.  
  1894.                ROBIN! 1.6 November 12, 1990                     page 32
  1895.  
  1896.  
  1897.  
  1898.           REGISTERING YOUR SHAREWARE VERSION OF ROBIN!          REGISTERING YOUR SHAREWARE VERSION OF ROBIN!
  1899.  
  1900.  
  1901.  
  1902.           WHAT DOES SHAREWARE MEAN?
  1903.  
  1904.                Shareware is a concept for distribution of software that
  1905.                allows people to try before they buy.  Shareware software
  1906.                developers allow you to make as many copies of their
  1907.                software as you like, freely give it to as many people as
  1908.                you like, and only pay for it if you (and they) decide to
  1909.                use it on a regular basis.  When you decide you like the
  1910.                software and will use it, then you register it, normally for
  1911.                a fee but often less than what you might pay for an
  1912.                equivalent commercial package.  With registration frequently
  1913.                comes other benefits like free upgrades, newsletters, pride
  1914.                of ownership and guiltless sleep at night.  These will vary
  1915.                from one program to another (particularly the guiltless
  1916.                sleep part).
  1917.  
  1918.                Now in reality, many people use shareware software on a
  1919.                regular basis and never pay for it.  Thus, very few software
  1920.                developers have made much money on shareware software.  That
  1921.                is unfortunate because there are a lot of shareware products
  1922.                floating around today that are worth their price.  There are
  1923.                also a lot of shareware software developers who work hard to
  1924.                produce a professional package, and get few rewards.  So why
  1925.                did we choose to distribute this version of ROBIN! as a
  1926.                shareware product?  Well to be honest here are our reasons:
  1927.  
  1928.                1) Most people using Prodigy are new to computers, and have
  1929.                   a hard time knowing what software they need, and paying
  1930.                   commercial prices for it.  This way they can try it free,
  1931.                   toss it if they find it useless, or pay a low price if
  1932.                   they find it useful.
  1933.                2) We just do not have the funds or backing to enter the
  1934.                   commercial market with ROBIN! in the traditional manner.
  1935.                3) We are rebels at heart, and kind of like being part of
  1936.                   the "underground" software market.
  1937.  
  1938.           HOW DO YOU REGISTER?
  1939.  
  1940.                If you decide to use ROBIN! on a regular basis, and we think
  1941.                you will, we ask that you register it with us.  We have two
  1942.                registration options, regular at $10.00 and extended at
  1943.                $15.00 (Do not worry about sales tax we will take care of
  1944.                that).  Here is what you get:
  1945.  
  1946.                Regular - Fee $10.00.  What you get - guiltless sleep about
  1947.                using ROBIN!, notification of new versions via EMAIL, TWEET
  1948.                ROBIN!'s newsletter as long as EMAIL is free, quick
  1949.                responses to questions via EMAIL as long as EMAIL is free.
  1950.  
  1951.  
  1952.  
  1953.                ROBIN! 1.6 November 12, 1990                     page 33
  1954.  
  1955.  
  1956.                Extended - Fee $15.00.  What you get - everything you get
  1957.                from the regular registration plus if you do not have the
  1958.                latest version, we will mail it to you free, plus one free
  1959.                future upgrade mailed to you.  We will notify you when each
  1960.                upgrade is available, what the new features are, and YOU
  1961.                decide when you want to cash in your free upgrade.
  1962.  
  1963.                To register your version of ROBIN!, send the following form
  1964.                (filled out please!), along with your registration fee to:
  1965.  
  1966.                   ROBIN!
  1967.                   McQuay Technologies
  1968.                   Suite 291
  1969.                   8045 Antoine
  1970.                   Houston TX 77088
  1971.  
  1972.  
  1973.  
  1974.                ROBIN! 1.6 November 12, 1990                     page 34
  1975.  
  1976.  
  1977.                DO NOT FORGET TO INCLUDE YOUR REGISTRATION FEE !
  1978.  
  1979.  
  1980.  
  1981.                Name    ___________________________________________
  1982.  
  1983.                Prodigy ID (IMPORTANT MUST INCLUDE!) ________________
  1984.  
  1985.                Address ___________________________________________
  1986.  
  1987.                        ___________________________________________
  1988.  
  1989.                        ___________________________________________
  1990.  
  1991.                [  ]  Regular Registration
  1992.  
  1993.                [  ]  Extended Registration.
  1994.  
  1995.                Which Version Of ROBIN! are you using? (you can find the
  1996.                version number on the System Menu)
  1997.  
  1998.                        ___________________________________________
  1999.  
  2000.                What kind of Computer Equipment are you using? (CPU, SPEED,
  2001.                VIDEO ADAPTER, HARD DISK SIZE ... etc)
  2002.  
  2003.                        ___________________________________________
  2004.  
  2005.                        ___________________________________________
  2006.  
  2007.                        ___________________________________________
  2008.  
  2009.                Any comments about ROBIN!?
  2010.  
  2011.                        ___________________________________________
  2012.  
  2013.                        ___________________________________________
  2014.  
  2015.                        ___________________________________________
  2016.  
  2017.                Where did you get your Shareware version of ROBIN!
  2018.  
  2019.                        ___________________________________________
  2020.  
  2021.                        ___________________________________________
  2022.  
  2023.                        ___________________________________________
  2024.  
  2025.  
  2026.  
  2027.                ROBIN! 1.6 November 12, 1990                     page 35
  2028.  
  2029.  
  2030.  
  2031.           THE REALITY OF SHAREWARE
  2032.  
  2033.                This last section is a warning, disclaimer, and plea.  If
  2034.                after a while we have very little cash flow on the shareware
  2035.                version of ROBIN!, we will probably drop support for it.
  2036.                All of us here at McQuay Technologies make our living doing
  2037.                other things in a variety of jobs.  We all have families.
  2038.                And we are all over achievers.  Time is our most precious
  2039.                resource.  So in reality we have to place priorities on our
  2040.                time.  We all enjoyed developing ROBIN!, and so far we have
  2041.                enjoyed supporting it.  But in the end, if ROBIN! does not
  2042.                benefit us financially, then we would rather spend time with
  2043.                our families (probably swimming, playing tennis, golf, or
  2044.                coaching soccer) and go off on another project.  We are sure
  2045.                you can all understand that approach to our work.  We
  2046.                developed Robin!.  We hope you like it.  More importantly we
  2047.                hope it makes a big enough difference in your life that you
  2048.                will gladly send us a little cash.  Please!
  2049.  
  2050.  
  2051.  
  2052.                ROBIN! 1.6 November 12, 1990                     page 36
  2053.  
  2054.  
  2055.  
  2056.           PROBLEMS          PROBLEMS
  2057.  
  2058.  
  2059.  
  2060.           POSSIBLE PROBLEMS AND SOLUTIONS
  2061.  
  2062.                1) Robin! displays an error message when I first run it.
  2063.  
  2064.                   There are several errors that could be displayed, almost
  2065.                   all of them relate to a file that ROBIN! uses is missing
  2066.                   or not located in the Prodigy director.  The following
  2067.                   files need to be in the Prodigy for ROBIN! to work
  2068.                   properly:
  2069.  
  2070.                          ROBIN!.EXE          ROBIN.BAT
  2071.                          RSCRIPT.RSF         ROBIN.DAT
  2072.                          LITT.CHR       VGA16.BGI
  2073.                          HERC.BGI       CGA.BGI
  2074.  
  2075.                   If these files are not in your directory, then you should
  2076.                   reinstall ROBIN! using your original disk or downloaded
  2077.                   ARC file.
  2078.  
  2079.                2) Robin! gives me an error message when I try to install
  2080.                   it.
  2081.  
  2082.                   There are couple reasons that the ROBIN! install program
  2083.                   would do this:
  2084.                   o you may not have enough memory to run ROBIN! and
  2085.                     Prodigy.  You need at least 512K of memory available at
  2086.                     run time which means you will have to have at least
  2087.                     640K of RAM installed.
  2088.                   o You do not have Prodigy installed in a subdirectory
  2089.                     called Prodigy.
  2090.                   o You have a version of Prodigy we have not seen.
  2091.                   o You are using a TANDY 1000 or an AMSTRAD which we have
  2092.                     no graphics driver to provide support.
  2093.  
  2094.                3) Prodigy gives me an API error message or Prodigy gives me
  2095.                   a DM error message.
  2096.  
  2097.                   This is most likely caused by not enough memory being
  2098.                   available for Prodigy.  Try running Prodigy again, do the
  2099.                   same thing that caused the error previously.  If the
  2100.                   error occurs again, try freeing up RAM by uninstalling
  2101.                   some of your TSRs.  See the UNLOAD TSRs in the appendix.
  2102.  
  2103.                5) Prodigy gives me a CM error message.
  2104.  
  2105.                   This is likely caused by something happening to your
  2106.                   phone line.  Call waiting will cause this error.  Also
  2107.                   somebody picking up the phone can cause this error.  If
  2108.  
  2109.  
  2110.  
  2111.                ROBIN! 1.6 November 12, 1990                     page 37
  2112.  
  2113.  
  2114.                   this becomes a persistent problem, try switching phone
  2115.                   jacks, or disconnecting your extension phones.
  2116.  
  2117.                6) Robin! will not work while I am using prodigy.
  2118.  
  2119.                   First, Try reinstalling ROBIN!.  Second check and see if
  2120.                   when your start ROBIN!, if it loads or if it displays a
  2121.                   message that it did not load.  If all this fails, send us
  2122.                   a note and we will try and help.
  2123.  
  2124.                7) Robin!'s Script Compiler gives me and error message.
  2125.  
  2126.                   There is an error in your script code.  Look in the list
  2127.                   file which ROBIN!'s script compiler generates.  It will
  2128.                   have the same name as the file you were compiling,
  2129.                   however it will have a RSL extension.  This list file
  2130.                   will show where the error was and what kind of error it
  2131.                   found.  It will look something like this:
  2132.  
  2133.                          SYNTAX ERROR LINE # 38
  2134.  
  2135.                8) A Robin! script I created will not work right.
  2136.  
  2137.                   First make sure you are starting it in the right place.
  2138.                   Then try doing what you wanted the script to do by hand.
  2139.                   Following your script instructions, see if it fails or if
  2140.                   it succeeds.  Be sure to use the compiler listing to make
  2141.                   sure you are following the EXACT key sequence in your
  2142.                   macro.  If it still fails, then find the right key
  2143.                   sequence to make it succeed.  If it succeeds, send us a
  2144.                   note.
  2145.  
  2146.                9) When I press ALT-TAB for the first time, ROBIN! locks up
  2147.                   my system.
  2148.  
  2149.                   Probably ROBIN! has not locked up your system, but just
  2150.                   is not configured for your current video mode.  Try
  2151.                   pressing the ESC key and see if your system becomes
  2152.                   unlocked.
  2153.  
  2154.                10) My computer locks up while I am using PRODIGY, but I was
  2155.                   not using any of ROBIN!'s features.
  2156.  
  2157.                   Most likely, somebody picked up your phone line.
  2158.  
  2159.                11) When I was installing ROBIN!, the install program told
  2160.                   me it did not support my video board.
  2161.  
  2162.                   If you are using a TANDY 1000 or AMSTRAD, then we do not
  2163.                   support those video modes at this time.  If you are using
  2164.                   a VGA board, then it is possible you have a version of
  2165.                   Prodigy we have not seen.  Send us a note which includes
  2166.                   which video mode you installed Prodigy for, and we can
  2167.                   give you a patch for your batch file.
  2168.  
  2169.  
  2170.  
  2171.                ROBIN! 1.6 November 12, 1990                     page 38
  2172.  
  2173.  
  2174.  
  2175.                12) I am using the EGA version of Prodigy and when I bring
  2176.                   up the Script menu, the characters are so large that go
  2177.                   outside of ROBIN!'s box.  Then parts of them get left
  2178.                   behind when I go back to Prodigy.
  2179.  
  2180.                   Most likely the file LITT.CHR is not in the directory
  2181.                   that ROBIN!.EXE and VGA16.BGI is located.  Copy it from
  2182.                   your master disk into this directory.
  2183.  
  2184.                13) When I am trying to upload a long note, after about the
  2185.                   4th or 5th message, Prodigy locks up or gives me an OCM
  2186.                   error message.
  2187.  
  2188.                   Likely ROBIN! has overwhelmed your Prodigy program or the
  2189.                   Prodigy node you are logged onto.  Try increasing the
  2190.                   value of the NodeWait field on the System Menu.  If that
  2191.                   solves the problem for your current session, but it
  2192.                   happens again later, you may want to use RCONFIG to
  2193.                   change this value permanently.
  2194.  
  2195.                14) While I am using ROBIN! to upload a long note, ROBIN!
  2196.                   makes Prodigy pause for a long time which is annoying.
  2197.  
  2198.                   Well, if you watch your modem lights, and they stop
  2199.                   blinking long before ROBIN!'s pause ends, you may want to
  2200.                   decrease the node wait value.  If that solves the problem
  2201.                   for your current session, but it happens again later, you
  2202.                   may want to use RCONFIG to change this value permanently.
  2203.  
  2204.                15) I installed version 3 of Prodigy, and now ROBIN! does
  2205.                   not work.
  2206.  
  2207.                   ROBIN! must be installed for the version of Prodigy that
  2208.                   you are using, install ROBIN! again.
  2209.  
  2210.                16) I want to install ROBIN!, but the install program can
  2211.                   not find Prodigy.
  2212.  
  2213.                   When RINSTALL tells you that Prodigy was not found, then
  2214.                   it will ask for a Path to where prodigy is installed.
  2215.                   Type in a full path (including drive ID) to where you
  2216.                   have Prodigy installed.
  2217.  
  2218.                17) While I am installing ROBIN!, a message appears on the
  2219.                   screen "Insert disk for drive B:", then if I press return
  2220.                   it displays "Insert disk for drive A:", and keeps going
  2221.                   back and forth between these two.
  2222.  
  2223.                   You only have one floppy drive.  But DOS emulates that
  2224.                   you have 2 floppies by allowing you to insert a disk for
  2225.                   drive A: and then take it out and insert another for
  2226.                   drive B:.  Just keep pressing the RETURN key in response
  2227.  
  2228.  
  2229.  
  2230.                ROBIN! 1.6 November 12, 1990                     page 39
  2231.  
  2232.  
  2233.                   to each of these prompts, until RINSTALL is done, and
  2234.                   ROBIN! should install fine
  2235.  
  2236.           HOW TO CONTACT US ABOUT ROBIN! PROBLEMS
  2237.  
  2238.                They best way to contact us is via Prodigy.  Our ID is
  2239.                WPTD01E.  Ask for Richard.  If you have to contact us by
  2240.                mail, you can send a letter or disk to
  2241.  
  2242.                   ROBIN!
  2243.                   McQuay Technologies
  2244.                   Suite 291
  2245.                   8045 Antoine
  2246.                   Houston TX 77088
  2247.  
  2248.                We can not be reached by phone, and likely will never
  2249.                provide phone support.  Sorry!
  2250.  
  2251.                When you contact us provide the following (You can upload
  2252.                the file HELPME.ASC as a template using the quickload
  2253.                option):
  2254.  
  2255.                1) Your registration number (Which we send you when you
  2256.                   register your copy of ROBIN!), the version of ROBIN! that
  2257.                   you are using (this is displayed when Robin! first runs),
  2258.                   where you obtained ROBIN! and your Prodigy ID.  If you do
  2259.                   not have a registration # we will still try and provide
  2260.                   support, but registered owners get priority in our help
  2261.                   que.
  2262.  
  2263.                2) A brief 5 to 10 line description of your problem.
  2264.  
  2265.                4) The type of display adapter you have, the type of
  2266.                   computer you have, how much RAM is installed, which
  2267.                   version of DOS do you have, which version of Prodigy, and
  2268.                   what other TSRs you are using..
  2269.  
  2270.  
  2271.                Here is an example
  2272.  
  2273.                   I can not get Prodigy to run when I use the ROBIN.BAT
  2274.                   file to start Prodigy.  It tells me I do not have enough
  2275.                   memory.  The install program said I had enough?
  2276.                   EGA adapter and EGA monitor with a Compaq portable III
  2277.                   with 3MB of RAM.  I have DOS 4.0 and I am using Prodigy
  2278.                   version 3.  I have a network TSR loaded while using
  2279.                   Prodigy.
  2280.  
  2281.                We may ask you for a copy of your Config.sys file, your
  2282.                autoexec.bat file, and the .BAT file from which you are
  2283.                running ROBIN! and Prodigy (Very helpful and will save a lot
  2284.                of time!).  If you have any questions about these files see
  2285.                the technical aspects of Prodigy section and the glossary of
  2286.                this document.
  2287.  
  2288.  
  2289.  
  2290.                ROBIN! 1.6 November 12, 1990                     page 40
  2291.  
  2292.  
  2293.  
  2294.                ROBIN! 1.6 November 12, 1990                     page 41
  2295.  
  2296.  
  2297.  
  2298.           APPENDIX          APPENDIX
  2299.  
  2300.  
  2301.  
  2302.           SYSTEM REQUIREMENTS
  2303.  
  2304.                An 8088, 8086, 80186, 80286, 80386, or 80486 system using
  2305.                MSDOS or PCDOS version 2.x, 3.x, or 4.x;  an external modem
  2306.                and a serial port or an internal modem(required for
  2307.                Prodigy), a CGA, EGA, VGA or Hercules graphics adapter, and
  2308.                640K of base memory.  When you run Prodigy and Robin!
  2309.                together there must be at least 512K of available memory.
  2310.                You must have either version 2 or 3 of Prodigy installed.
  2311.  
  2312.  
  2313.           INSTALLING ON A FLOPPY SYSTEM
  2314.  
  2315.                ROBIN!'s install program is designed to install ROBIN! on
  2316.                systems that have a hard disk.  However, ROBIN! will work on
  2317.                a floppy system.  To install ROBIN! on a floppy system,
  2318.                first make a backup copy of your ROBIN! disk.  You will use
  2319.                this disk to start ROBIN!.  Follow the steps below:
  2320.  
  2321.                  1) Follow these steps for the version of Prodigy you are
  2322.                     using:
  2323.  
  2324.                     Version 3
  2325.  
  2326.                     Do a directory of your Prodigy disk.  Look at the size
  2327.                     of the file called DRIVER.SCR.  You will need to record
  2328.                     the following video codes for the size of file you
  2329.                     have:
  2330.  
  2331.                               Video     File           Video   File
  2332.                               Code      Size           Code    Size
  2333.                               -----     ------         -----   -----
  2334.                               C         15416          H       21348
  2335.                               E         15486          P       10969
  2336.                               M         17757
  2337.                               U         22092
  2338.                               V         24565
  2339.  
  2340.  
  2341.                     Version 2
  2342.  
  2343.                     You will need to record the following video codes for
  2344.                     the equipment you have:
  2345.  
  2346.                     H - Hercules Graphics Card
  2347.  
  2348.                     C - CGA Card
  2349.  
  2350.                     E - EGA or VGA Card
  2351.  
  2352.  
  2353.  
  2354.                ROBIN! 1.6 November 12, 1990                     page 42
  2355.  
  2356.  
  2357.                  2) Insert your ROBIN! disk in drive A:
  2358.  
  2359.                     Type
  2360.  
  2361.                     COPY CON: ROBIN.BAT
  2362.  
  2363.                     and press RETURN.
  2364.  
  2365.                     Then type the following but replace the '#' below with
  2366.                     the character you have recorded for your video system
  2367.                     above:
  2368.  
  2369.                     ROBIN! V=# A=%1
  2370.  
  2371.                     For example, if 'C' was the video code for your system
  2372.                     you would type
  2373.  
  2374.                     ROBIN! V=C A=%1
  2375.  
  2376.                     Then press RETURN and then press the F6 key (or enter a
  2377.                     CNTRL-Z) and press RETURN.
  2378.  
  2379.                  3) To start ROBIN!, insert your ROBIN! disk in drive A:
  2380.                     and type
  2381.  
  2382.                     A:
  2383.                     ROBIN
  2384.  
  2385.                     This will load ROBIN!.  Then insert your Prodigy disk
  2386.                     and start Prodigy as you usually would.  When you exit
  2387.                     Prodigy, insert your ROBIN! disk and type
  2388.  
  2389.                     ROBIN! U
  2390.  
  2391.                     This will unload ROBIN!
  2392.  
  2393.  
  2394.           MEMORY PROBLEMS - UNLOADING TSRS
  2395.  
  2396.                The following describes how to unload various TSRs or DOS
  2397.                features.  Unless you are using a TSR manager, unloading
  2398.                TSRs can be difficult.  Generally TSRs needed to be unloaded
  2399.                in the reverse order that they were loaded.
  2400.  
  2401.                PCTOOLS - There are two ways to unload PCTOOLS (desktop
  2402.                shell etc).  PCTOOLS comes with a program called KILL.EXE
  2403.                (really!).  Running this command from the command line will
  2404.                unload PCTOOLS assuming that PCTOOLS is the next in line to
  2405.                be unloaded.  You can also unload PCTOOLS from the program
  2406.                itself by selecting the Tools option in the main menu and
  2407.                selectin UnLOAD as the action.
  2408.  
  2409.                WINDOWDOS - WindowDOS can be unloaded by running WindowDOS
  2410.                with the U command line switch.
  2411.  
  2412.  
  2413.  
  2414.                ROBIN! 1.6 November 12, 1990                     page 43
  2415.  
  2416.  
  2417.  
  2418.           TECHNICAL ASPECTS OF ROBIN!
  2419.  
  2420.                ROBIN! is a fairly sophisticated program (at least we like
  2421.                to think so).  It has been designed to be a friendly TSR
  2422.                program, and to use as little memory as possible.  It still
  2423.                uses a lot though.  We are constantly trying to streamline
  2424.                ROBIN! and make it work with less memory.  Right now, your
  2425.                version of ROBIN! requires between 75K and 80K, depending on
  2426.                what video equipment you have.  We found writing ROBIN! to
  2427.                work transparently under version 2 of Prodigy to be very
  2428.                difficult.  To be blunt, we consider version 2 of Prodigy to
  2429.                be unstable and version 3 to be unfriendly.  The only thing
  2430.                more unstable than this code is the tech support you get
  2431.                when you have problems.  Version 3s mouse support is very
  2432.                unfriendly and caused a variety of problems.  We have found
  2433.                that almost all of the problems we have experienced with
  2434.                Prodigy have resulted from not enough memory available or a
  2435.                communications problem.
  2436.  
  2437.                For those of you that are technically oriented, we thought
  2438.                we would share with you some of the technical aspects of
  2439.                ROBIN!.  First of all, ROBIN! is written using Borland's
  2440.                Turbo Pascal(r) Ver. 5.5.  It does utilize some of the
  2441.                object oriented features of the language.  We used Turbo
  2442.                Power Software's Object Professional(r) package for most of
  2443.                the low level TSR support.  The graphics are generated with
  2444.                Borland's BGI graphics system.  A substantial portion of
  2445.                ROBIN! is written in very carefully crafted assembly
  2446.                language, compiled with Borland's TASM.  Except for the size
  2447.                of the BGI kernal, we are pleased with this development
  2448.                configuration.
  2449.  
  2450.                To reduce the amount of memory needed to save and restore
  2451.                Prodigy's screens, a scratch file is created and data is
  2452.                written to and read from this file each time a ROBIN! menu
  2453.                is first placed on the screen.  We chose this technique over
  2454.                saving in to memory because it required 12K to save
  2455.                Prodigy's EGA screen.  Using this technique saved 10K in
  2456.                memory.  Some will experience some performance degradation
  2457.                with this approach, but for many the approach would have
  2458.                been this or nothing.  For those with a RAM disk, there is a
  2459.                switch to allow the scratch file to be saved on the RAM
  2460.                disk.  See the Command Line Switches section.
  2461.  
  2462.                ROBIN! was developed with little technical assistance from
  2463.                the Prodigy people.  They did provide us a BETA version of
  2464.                the Version 3 software.  For this we are very grateful.
  2465.                Most of the work however, was trial and error.  One of the
  2466.                most time consuming aspects of ROBIN! was mastering
  2467.                Prodigy(r) word processor.  Essentially ROBIN! has to
  2468.                understand all the quirks of the system in order to be able
  2469.                to upload files as efficiently as it does.  This was a pain.
  2470.                It is possible that there are some quirks we have not
  2471.  
  2472.  
  2473.  
  2474.                ROBIN! 1.6 November 12, 1990                     page 44
  2475.  
  2476.  
  2477.                discovered, and if you find em, we really want to hear about
  2478.                it.
  2479.  
  2480.                One of the fundamental aspects of ROBIN! is the script
  2481.                system.  Almost every feature of ROBIN! utilizes the
  2482.                internal script engine.  Many of the upload and logon
  2483.                feature are driven by internal scripts.  This is so critical
  2484.                to ROBIN! and, as we found, so difficult to do with
  2485.                Prodigy(r) that we consider it to be a trade secret, and are
  2486.                registering it.  ROBIN! is not simply filling the keyboard
  2487.                buffer with keystrokes.  This is why ROBIN! is capable of
  2488.                uploading 48K worth of text to Prodigy.
  2489.  
  2490.                The ROBIN! script system is actually a tokenized system,
  2491.                with the Script Compiler creating a intermediate token
  2492.                language which the ROBIN! main system interprets at run
  2493.                time.
  2494.  
  2495.                Messing with the .RSF files will likely result in critical               Messing with the .RSF files will likely result in critical
  2496.                errors and is strongly discouraged.  We have not tried it               errors and is strongly discouraged.  We have not tried it
  2497.                and really have no idea what might happen if you try it.
  2498.  
  2499.  
  2500.           SOME TECHNICAL ASPECTS OF PRODIGY(r), WE THINK!
  2501.  
  2502.                Gathering together info about the technical aspects of
  2503.                Prodigy is difficult.  As most of you know, the manuals that
  2504.                come with Prodigy provide NO technical information.  So most
  2505.                of the info we have on Prodigy comes either from Bulletins
  2506.                posted, from the ASK PRODIGY tech notes, or just our
  2507.                experience.
  2508.  
  2509.                Right now we consider Prodigy ver 2 to be an unstable
  2510.                program.  That is it does not react or recover well from
  2511.                events that are out of the ordinary or beyond what Prodigy
  2512.                expects to happen.  We have tried to design ROBIN! to work
  2513.                in this unstable environment.  Version 3 is much more
  2514.                stable, but is still not written in a way that is friendly
  2515.                to TSRs.
  2516.  
  2517.                One critical aspect of the Version 2 Prodigy system that we
  2518.                discovered that is important to ROBIN! users is that memory
  2519.                checking is not done by the Prodigy system at runtime, but
  2520.                rather by Prodigy's initial menu (MENU.EXE).  Interestingly,
  2521.                Prodigy can actually run under less memory than the Menu
  2522.                program checks.  For those of you having memory problems, a
  2523.                recommendation of last resort is that you load ROBIN! after
  2524.                the MENU program is run in your batch file that starts
  2525.                Prodigy.  Unfortunately with out this initial memory check,
  2526.                if Prodigy runs out of memory it will just crash (hard).  If
  2527.                you are lucky you will get an API error code.  We also found
  2528.                that sometimes you can get an API code even if the Menu
  2529.                program decides there is enough memory.
  2530.  
  2531.  
  2532.  
  2533.                ROBIN! 1.6 November 12, 1990                     page 45
  2534.  
  2535.  
  2536.                Version 3 has one EXE program that simplifies the starting
  2537.                of Prodigy.  This version does its error checking at
  2538.                runtime, and will generate a fatal error if it does not have
  2539.                enough memory.
  2540.  
  2541.                The Prodigy program is also very sensitive to communication
  2542.                noise.  For example, if some one picks up an extension while
  2543.                you are online, it is very likely that Prodigy will just
  2544.                lock up your computer and you will have to reboot.  If your
  2545.                lucky you will get a CM error code.
  2546.  
  2547.                Prodigy has a voracious appetite for keystrokes.  It
  2548.                frequently just sucks up keystrokes in the keyboard buffer
  2549.                and tosses them away.  It is one reason why so many TSR
  2550.                macro programs have problems with Prodigy.  Prodigy ver 2
  2551.                actually has an undocumented feature that allows it to use a
  2552.                log file of keystrokes to start Prodigy.  This makes a very
  2553.                cheap autologin feature for Prodigy and is one way to start
  2554.                Prodigy and preform some automated tasks.
  2555.  
  2556.                Prodigy mail service is fairly fast in posting private
  2557.                messages, but it is not instantaneous.  Using ROBIN! to send
  2558.                long notes (files that have more text than one message) is
  2559.                fairly fast.  And it is not likely that a multiple message
  2560.                file would be split in some ones mail box by another
  2561.                message, but it is possible.  This really should be of no
  2562.                real inconvenience if it happens, and there is really
  2563.                nothing you can do to avoid it other than posting your
  2564.                message at a non peak hour.
  2565.  
  2566.                There are a variety of files in your Prodigy directory.  Two
  2567.                are interesting, CACHE.DAT and STAGE.DAT.  These files
  2568.                apparently used by Prodigy to store information as it is
  2569.                received.  STAGE.DAT seems to have the most recent info, and
  2570.                CACHE.DAT is a temporary overflow for STAGE.  Some people
  2571.                have reported problems with these two files in Version 2.
  2572.  
  2573.                Below we have tried to assemble the "known" Prodigy error
  2574.                codes, with some "reason" why they may be occurring and what
  2575.                you can do to avoid or correct them.  We have qualified the
  2576.                phrases "known" and "reason" because the only place some of
  2577.                these have been documented is in the Public exchange on the
  2578.                Ask Prodigy bulletin board.  Each provides a letter code,
  2579.                which will be followed by a Number.
  2580.  
  2581.                   CM # - Communication error.  Caused by noise on the line,
  2582.                   some one picking up the phone, bad modem, etc.  Hang up
  2583.                   and try again.
  2584.  
  2585.                   API # - An error condition was detected in a Prodigy
  2586.                   application.  Our experience with this error has been
  2587.                   related to not enough memory, particularly error number 8
  2588.                   and 15.  Interestingly, prodigy online tech people say
  2589.                   "avoid this application area for a while if this occurs."
  2590.  
  2591.  
  2592.  
  2593.                ROBIN! 1.6 November 12, 1990                     page 46
  2594.  
  2595.  
  2596.                   What?  Apparently this is also an error code for a bug or
  2597.                   something.  Try to free up more RAM.
  2598.  
  2599.                   DM # - The display module detected an error, more than
  2600.                   likely not enough RAM.  Try and free up more RAM.
  2601.  
  2602.                   OMCM # - This is a rather low level error that indicates
  2603.                   that the communications interface detected an error in
  2604.                   transmission.  A data packet was found to fail the
  2605.                   checksum test.  It is possible to upload a very long
  2606.                   file, on a fast machine and generate this error.  Try
  2607.                   breaking the file up into smaller chunks, or increase
  2608.                   your NODE WAIT value in the system menu.
  2609.  
  2610.                   KM # - This error apparently is a Prodigy System error on
  2611.                   the host computer.  Is a bug in the Host Prodigy
  2612.                   software.  Report this error to Prodigy and then "Try and
  2613.                   avoid this application for a while."  Well, what else
  2614.                   would you do?
  2615.  
  2616.                   OBS # - This is an error at your current local Prodigy
  2617.                   node (local access number).  Report this to Prodigy when
  2618.                   you call back.
  2619.  
  2620.                   OMS # and SMGR # - These are two unusual errors that have
  2621.                   been associated with the Stage.DAT file.  Prodigy uses
  2622.                   this file to store "stuff".  Occasionally users have
  2623.                   experienced this file growing to enormous size.  For
  2624.                   version 2.1 of Prodigy it size should be no larger than
  2625.                   about 200,064 bytes.  Version 3 can be as big as 1 MB.
  2626.                   Most advice to date is that with this error, or if you
  2627.                   see the file larger than this, copy the original RS.EXE
  2628.                   and STAGE.DAT back into your Prodigy Directory.
  2629.  
  2630.           SOME NON TECHNICAL ASPECTS OF ROBIN!
  2631.  
  2632.                One thing that has greatly pleased us is that ROBIN! has
  2633.                actually generated a lot of uses we never really envisioned
  2634.                when we first started creating it.  This section discusses a
  2635.                couple of ideas.  We think there will be a lot more and we
  2636.                want to hear about them, so be creative!
  2637.  
  2638.                Forwarding mail.  Ever get a message from someone that was
  2639.                meant for someone else.  Or get a message you would like to
  2640.                share with others.  Using ROBIN!'s download and upload
  2641.                features you can do this very quickly.  In fact you can
  2642.                create a script to help with the process.  When you are in a
  2643.                message you want to forward, just open a download file, call
  2644.                it temp.asc, print the message, then close the print file.
  2645.                Then select the write feature, enter the ID to whom you
  2646.                which to forward it, and send it with a ROBIN! upload,
  2647.                uploading TEMP.ASC.  The script you can create can be evoked
  2648.                to automatically print the file and take you over to the
  2649.  
  2650.  
  2651.  
  2652.                ROBIN! 1.6 November 12, 1990                     page 47
  2653.  
  2654.  
  2655.                write message.  You than close the file, enter the ID,and
  2656.                upload.
  2657.  
  2658.                Create a Log File.  ROBIN!'s download feature does not limit
  2659.                you to one message.  You can open a file and download a
  2660.                whole lot of messages.  Ever find your mailbox full of
  2661.                messages making it a pain to find the one you want, but you
  2662.                don't want to delete any.  Open a log file, and print them
  2663.                all, then delete them.  You can even have one log file that
  2664.                you just keep appending messages to.  You can even create a
  2665.                script that prints a message, deletes the message, and then
  2666.                moves to the next message.
  2667.  
  2668.  
  2669.           POSSIBLE FUTURE ENHANCEMENTS
  2670.  
  2671.                It is our intent to continue to provide enhancements to
  2672.                ROBIN!  What has been done to date has required a lot of
  2673.                effort.  Our reward to date has been self satisfaction and
  2674.                the use of a productivity tool that meets our needs.  That
  2675.                has been enough so far.  But, continued improvement of a
  2676.                shareware version without any of reward for our efforts just
  2677.                does not excite any of us.  We will give Robin! a chance and
  2678.                see how many people register the version they are using.
  2679.  
  2680.                There are several enhancements we have in the works that we
  2681.                will provide through a future upgrade of the shareware
  2682.                version.  The biggest barrier right now is memory.  We are
  2683.                trying to trim down the memory requirements of ROBIN! so we
  2684.                can add new features.  One possible solution will be to use
  2685.                overlays.
  2686.  
  2687.                We will also try to keep up with changes that Prodigy
  2688.                services may make in the Prodigy system that affect the
  2689.                operation of ROBIN!.  This version of ROBIN! was developed
  2690.                under Prodigy 2.1 and 3.0.  We will release and upgrade for
  2691.                future versions when they become available to us.
  2692.  
  2693.                One big change in Prodigy's service that may change our
  2694.                support for ROBIN! is the proposed EMAIL surcharge.  This is
  2695.                something we can ill afford.  If this action occurs, it will
  2696.                destroys the "community" that has developed on Prodigy.
  2697.                After this there will likely be no market for ROBIN!.
  2698.  
  2699.                Here are some of the features we think may be (or know are)
  2700.                technically possible, let us know which ones excite you:
  2701.  
  2702.                1) Expand the Robin Script Language to include features such
  2703.                   as the ability to add looping in scripts and be able to
  2704.                   test certain Prodigy(r) conditions (like new mail).
  2705.                2) Be able to load alternative script files while online
  2706.                   with prodigy.
  2707.                3) A script library manager,
  2708.  
  2709.  
  2710.  
  2711.                ROBIN! 1.6 November 12, 1990                     page 48
  2712.  
  2713.  
  2714.                4) Enhanced memory management including the use of EMS
  2715.                   memory if available,
  2716.                5) An online Text based word processor that is better than
  2717.                   prodigy's,
  2718.                6) be able to send small .EXE or .COM via Prodigy using an
  2719.                   automated HEX file format.
  2720.                7) be able to execute very large scripts contained in a
  2721.                   specific file.
  2722.                8) provide links to special programs such as stock market
  2723.                   analyzers.
  2724.                9) Be able to record keystrokes while in ROBIN!
  2725.                10) Print screen (doubt we will add this),
  2726.                11) Online Script debugger.
  2727.                12) Keep track of when IDs log on and provide an
  2728.                   automatically incrementing date to stick in the date
  2729.                   field on the BBS browse dialog boxes, and
  2730.                13) Use Prodigy's autologon files rather than ROBIN.DAT.
  2731.  
  2732.           WHY IS IT CALLED ROBIN!?
  2733.  
  2734.                Good question.  That deserves a story.
  2735.  
  2736.                Once upon a time their was a not so typical house with a
  2737.                GrandPa Bear, Grandma Bear, Pappa Bear, a Mamma Bear, a
  2738.                Sister Bear named Robin, and a Baby Bear.  Now into the Bear
  2739.                house came Prodigy!  First GrandPa Bear tried it, and said
  2740.                "Phoey!".  Pappa Bear tried Prodigy and said "This is
  2741.                interesting, but it is awfully slow, is a pain to get around
  2742.                in, bores me with the stupid little ads, and is an unstable
  2743.                program that really upsets my finally tuned 386!"  Sister
  2744.                Robin Bear watched Pappa Bear and said "OOOHHH thats rad,
  2745.                can I get on there and cruise around dad."  Papa Bear let
  2746.                Sister Bear have a wack at it and before Pappa could even
  2747.                blink, she became a Prodigy "prodigy".  Now Baby Bear
  2748.                watched Pappa Bear and said "Oh that is neat, I want to do
  2749.                that, hold me daddy and help me."  "Not now Baby Bear, get
  2750.                Robin to help you." said Pappa Bear.  "ROBIN!", cried Baby
  2751.                Bear, "help me, help me, help me!"; and she did.  Then
  2752.                Grandma Bear watched GrandPa Bear and said "You mean I can
  2753.                order groceries and they will deliver to my door and I do
  2754.                not have to fight traffic or haul bags around .... breath
  2755.                ... help me."  "Phoey!', said GrandPa bear, "Tell that Robin
  2756.                to do something constructive for a change."  So GrandMa Bear
  2757.                shouted "ROBIN! come here and help me work this!"  And Robin
  2758.                Bear did just that.  Then Mamma Bear watched Pappa Bear, and
  2759.                said "You mean I could send as many notes as I wanted to
  2760.                your mother, my mother, my sister, Sarah, Diane ....breath
  2761.                ...  and it would not cost anything and they would get them
  2762.                right away and could write right back the same day and I
  2763.                would not need to be home and they would not need to be home
  2764.                and ....(breath)..... Show me."  "I do not have time now,"
  2765.                said Pappa Bear, "get Robin to help you."  So Mamma Bear
  2766.                shouted, "ROBIN! come here and show me how to work this!"
  2767.                So Robin Bear did.
  2768.  
  2769.  
  2770.  
  2771.                ROBIN! 1.6 November 12, 1990                     page 49
  2772.  
  2773.  
  2774.                One day Robin Bear said to Pappa Bear, "You know dad, it
  2775.                would really be bogus if you zapped a little robot that can
  2776.                help Mom, and GrandMa and the brat when you and I are not
  2777.                around."  And with that, ROBIN! was launched.
  2778.  
  2779.  
  2780.           WHAT IS MCQUAY TECHNOLOGIES?
  2781.  
  2782.                Almost 10 years ago, with the birth of the 6502 and the Z80,
  2783.                a few of us became entranced by the capabilities of
  2784.                microcomputers.  We were all "professionals" in a variety of
  2785.                unrelated fields and from varying backgrounds, and our
  2786.                imaginations ran wild with the possibilities.  But after a
  2787.                few years we became disappointed in the things for which
  2788.                micros were being used.  So in our spare time we started
  2789.                pushing our machines to their limits and applying what we
  2790.                learned to our chosen fields.  To support our habit and our
  2791.                drive to stay on the leading edge while pursuing somewhat
  2792.                unrelated fields, we formed a partnership called McQuay
  2793.                Technologies.  We have all become fairly successful in our
  2794.                other careers (some what due to McQuay Technology projects),
  2795.                but McQuay Technologies has remained alive and we are still
  2796.                pushing our systems to their limits, exploring new
  2797.                possibilities (which still seem endless).
  2798.  
  2799.                ROBIN! became a challenge, so after many sleepless nights it
  2800.                now is available to you.  We see a lot of possibilities for
  2801.                Prodigy(r) and feel strongly that ROBIN! may be able to
  2802.                accelerate the reality of these possibilities.  And if it
  2803.                helps to feed your and our habit along the way, so much the
  2804.                better.
  2805.  
  2806.                We hope you will find ROBIN! and this document unique,
  2807.                innovative, provocative, useful, and standard setting.
  2808.                There now, aren't we just the worst greedy little
  2809.                egotistical monsters you have ever met! ;-)